Membenamkan siaran Instagram di laman web dengan oEmbed
Endpoint oEmbed Instagram Meta, GET /instagram_oembed?url=<POST_URL>, mengembalikan HTML yang membenamkan siaran atau Reel Instagram awam pada halaman web, beserta version, provider_name, provider_url, type dan width. Sejak 15 Mei 2026, ia boleh dipanggil tanpa token akses, dan HTML itu memuatkan embed.js Instagram untuk melukis siaran tersebut.
easyCoexistence memulangkan permalink setiap siaran Instagram yang disambungkan melalui list_social_posts, sedia untuk dihantar kepada oEmbed, dan membolehkan Claude, ChatGPT atau kod anda sendiri menerbitkan, menjadualkan dan membalas komen serta DM pada akaun itu melalui API rasmi Meta.
Sejak tarikh ini, API oEmbed Instagram Meta boleh dipanggil tanpa token akses, dalam semua versi.
Bilangan permintaan setiap jam yang dibenarkan oleh panduan oEmbed Meta.
Julat yang diterima oleh maxwidth; maxheight tidak disokong.
author_name, author_url dan medan thumbnail telah dikeluarkan daripada respons oEmbed Instagram dalam semua versi API.
Tidak disokong oleh endpoint oEmbed, begitu juga siaran daripada akaun persendirian, tidak aktif atau terhad umur.
Bagaimana endpoint oEmbed Instagram berfungsi?
Anda hantar URL siaran awam dan menerima semula HTML yang memaparkannya. Endpoint ini berjalan pada hos Graph API utama Meta, iaitu yang digunakan oleh panggilan Facebook Login, bukan graph.instagram.com. Respons ialah objek JSON kecil, dan medan html dimasukkan ke dalam halaman seperti sedia ada.
GET /instagram_oembed?url=https://www.instagram.com/p/<SHORTCODE>/
{
"version": "1.0",
"provider_name": "Instagram",
"provider_url": "https://www.instagram.com/",
"type": "rich",
"width": 658,
"html": "<EMBED_HTML>"
}URL mana yang diterima?
Tiga format, seperti yang disenaraikan oleh panduan Meta untuk parameter url, yang boleh dihantar biasa atau dikod URL; dua contoh permintaan dalam panduan itu menunjukkan satu daripada setiap format:
- Imej tunggal dan siaran karusel: https://www.instagram.com/p/{media-shortcode}/
- Video dan Reel: https://www.instagram.com/reel/{media-shortcode}/
- Profil: https://www.instagram.com/{username}
Adakah ia memerlukan token akses?
Tidak sejak 15 Mei 2026, apabila changelog Meta menyatakan bahawa API oEmbed Instagram boleh dipanggil tanpa token. Sebelum itu, aplikasi memerlukan ciri Meta oEmbed Read melalui App Review dan token pada setiap panggilan, dan akses berasaskan token masih berfungsi. Panduan oEmbed Meta membenarkan sehingga 1,000 permintaan sejam, dan pengumuman Meta tentang akses tanpa token menyatakan aplikasi berasaskan token mungkin mendapat had kadar yang lebih tinggi.
Apakah parameter yang diambil?
Empat selain url, daripada panduan dan rujukan Meta:
- maxwidth: dari 320 hingga 658; benaman sebaliknya responsif, dan maxheight tidak disokong.
- hidecaption: true menyembunyikan kapsyen siaran; nilai lalainya ialah false.
- omitscript: true mengeluarkan skrip daripada HTML, untuk halaman yang memuatkan embed.js sendiri sekali dan memanggil instgrm.Embeds.process().
- fields: mengehadkan respons kepada medan yang dinamakan.
Apakah yang terkandung dalam respons?
Enam medan lalai: html, markup untuk dipaparkan; version, sentiasa 1.0; provider_name dan provider_url, yang menamakan Instagram; type, jenis sumber oEmbed; dan width, dalam piksel. Meta mengeluarkan author_name, author_url, thumbnail_url, thumbnail_width dan thumbnail_height daripada respons siaran Instagram dalam semua versi API pada 3 November 2025. Bagi siaran akaun anda sendiri, edge media masih mengembalikan username, permalink dan thumbnail_url.
Apa yang tidak boleh dibenamkan?
Panduan Meta menyenaraikan perkara yang endpoint ini tidak merangkumi, dan satu peraturan penggunaannya:
- Siaran daripada akaun persendirian, tidak aktif dan terhad umur.
- Akaun yang telah mematikan benaman.
- Story, dan halaman yang memaparkan benaman di dalam Shadow DOM.
- Sebarang penggunaan selain paparan hadapan: Meta dengan tegas melarang penggunaan metadata atau kandungan endpoint untuk tujuan lain.
Bagaimana anda membenamkan siaran akaun anda sendiri?
Ambil permalink setiap siaran dan hantarnya sebagai url. Melalui easyCoexistence, list_social_posts mengembalikan siaran terkini akaun yang disambungkan beserta permalink-nya, daripada Claude, ChatGPT atau kod anda sendiri, dan kerana panggilan oEmbed tidak memerlukan token, laman web anda boleh membuat panggilan itu secara terus.
Kesilapan biasa
- Menghantar pautan Story. Endpoint oEmbed Meta tidak menyokong Story, jadi benamkan siaran atau Reel.
- Membaca thumbnail_url daripada respons. Meta mengeluarkannya, bersama author_name dan medan thumbnail yang lain, pada 3 November 2025.
- Menetapkan maxwidth di bawah 320 atau di atas 658. Meta hanya menerima nilai dalam julat itu, dan tiada maxheight langsung.
- Memuatkan embed.js bagi setiap benaman. Dengan omitscript ditetapkan kepada true, muatkan skrip sekali sahaja dan panggil instgrm.Embeds.process().
US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Bolehkah saya membenamkan Reel Instagram?
Boleh. Hantar URL https://www.instagram.com/reel/{media-shortcode}/ itu, dan endpoint akan mengembalikan HTML benaman.
Adakah benaman Instagram responsif?
Ya. Panduan Meta menyatakan benaman itu responsif, dan maxwidth menetapkan lebar maksimum.
Bolehkah saya membenamkan profil Instagram?
Ya. Panduan Meta menyenaraikan URL profil, https://www.instagram.com/{username}, antara format yang diterima oleh parameter url.
Bolehkah saya menggunakan data oEmbed untuk analitik?
Tidak. Meta hanya membenarkan endpoint itu untuk memaparkan siaran pada halaman atau dalam aplikasi, dan melarang penggunaan lain metadata serta kandungannya.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada