Menyematkan postingan Instagram di situs web dengan oEmbed
Endpoint oEmbed Instagram dari Meta, GET /instagram_oembed?url=<POST_URL>, mengembalikan HTML yang menyematkan postingan atau Instagram Reel publik di halaman web, beserta version, provider_name, provider_url, type, dan width. Sejak 15 Mei 2026 endpoint ini dapat dipanggil tanpa access token, dan HTML memuat embed.js milik Instagram untuk menggambar postingan tersebut.
easyCoexistence mengembalikan permalink setiap postingan Instagram yang terhubung melalui list_social_posts, siap dikirim ke oEmbed, dan memungkinkan Claude, ChatGPT, atau kode Anda sendiri untuk menerbitkan, menjadwalkan, dan membalas komentar serta DM pada akun melalui API resmi Meta.
Sejak tanggal ini, API oEmbed Instagram dari Meta dapat dipanggil tanpa access token, di semua versi.
Jumlah permintaan per jam yang diizinkan oleh panduan oEmbed Meta.
Rentang yang diterima maxwidth; maxheight tidak didukung.
Sejak author_name, author_url, dan field thumbnail dihapus, respons oEmbed Instagram di semua versi API tidak lagi menyertakannya.
Story tidak didukung oleh endpoint oEmbed, begitu pula postingan dari akun privat, tidak aktif, atau dibatasi usia.
Bagaimana cara kerja endpoint oEmbed Instagram?
Anda mengirim URL postingan publik dan menerima HTML yang menampilkannya. Endpoint ini berjalan di host Graph API utama Meta, yaitu host yang juga dipakai panggilan Facebook Login, bukan graph.instagram.com. Responsnya berupa objek JSON kecil, dan field html-nya dimasukkan langsung ke halaman apa adanya.
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 apa saja yang diterima?
Tiga format, sebagaimana tercantum dalam panduan Meta untuk parameter url. URL bisa dikirim apa adanya atau dalam bentuk URL-encoded. Dua contoh permintaan dalam panduan menunjukkan masing-masing satu:
- Postingan gambar tunggal dan carousel: https://www.instagram.com/p/{media-shortcode}/
- Video dan Reel: https://www.instagram.com/reel/{media-shortcode}/
- Profil: https://www.instagram.com/{username}
Apakah perlu access token?
Tidak sejak 15 Mei 2026, saat catatan perubahan Meta menyatakan bahwa API oEmbed Instagram dapat dipanggil tanpa token. Sebelumnya, aplikasi harus memiliki fitur Meta oEmbed Read melalui App Review dan mengirim token pada setiap panggilan. Akses dengan token masih berfungsi. Panduan oEmbed Meta mengizinkan hingga 1.000 permintaan per jam, dan pengumuman Meta tentang akses tanpa token menyebutkan bahwa aplikasi berbasis token mungkin mendapat pembatasan laju yang lebih tinggi.
Parameter apa saja yang diterima?
Empat selain url, dari panduan Meta dan referensinya:
- maxwidth: dari 320 hingga 658; penyematan selebihnya responsif, dan maxheight tidak didukung.
- hidecaption: true menyembunyikan keterangan postingan; nilai defaultnya false.
- omitscript: true membuat script tidak disertakan dalam HTML, untuk halaman yang memuat embed.js sendiri satu kali dan memanggil instgrm.Embeds.process().
- fields: membatasi respons hanya pada field yang disebutkan.
Apa isi responsnya?
Enam field default: html, markup yang akan ditampilkan; version, selalu 1.0; provider_name dan provider_url, yang menyebut Instagram; type, jenis resource oEmbed; dan width, dalam piksel. Meta menghapus author_name, author_url, thumbnail_url, thumbnail_width, dan thumbnail_height dari respons postingan Instagram di semua versi API pada 3 November 2025. Untuk postingan di akun Anda sendiri, media edge tetap mengembalikan username, permalink, dan thumbnail_url.
Apa yang tidak bisa disematkan?
Panduan Meta mencantumkan apa saja yang tidak disertakan endpoint ini, serta satu aturan penggunaannya:
- Postingan dari akun privat, tidak aktif, dan dibatasi usia.
- Akun yang telah menonaktifkan penyematan.
- Story, dan halaman yang merender penyematan di dalam Shadow DOM.
- Penggunaan apa pun di luar tampilan front-end: Meta secara tegas melarang penggunaan metadata atau konten endpoint untuk tujuan lain.
Bagaimana cara menyematkan postingan akun Anda sendiri?
Ambil permalink setiap postingan dan kirimkan sebagai url. Melalui easyCoexistence, list_social_posts mengembalikan postingan terbaru akun yang terhubung beserta permalink-nya, dari Claude, ChatGPT, atau kode Anda sendiri. Karena panggilan oEmbed tidak memerlukan token, situs Anda dapat langsung melakukan panggilan tersebut.
Kesalahan umum
- Mengirim tautan Story. Endpoint oEmbed Meta tidak mendukung Story, jadi sematkan postingan atau Reel.
- Membaca thumbnail_url dari respons. Meta menghapusnya, bersama author_name dan field thumbnail lainnya, pada 3 November 2025.
- Mengatur maxwidth di bawah 320 atau di atas 658. Meta hanya menerima nilai dalam rentang itu, dan maxheight tidak diterima sama sekali.
- Memuat embed.js pada setiap penyematan. Dengan omitscript diatur ke true, muat script sekali saja lalu panggil instgrm.Embeds.process().
US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah saya menyematkan Instagram Reel?
Bisa. Kirimkan URL https://www.instagram.com/reel/{media-shortcode}/ dan endpoint akan mengembalikan HTML penyematannya.
Apakah penyematan Instagram responsif?
Ya. Panduan Meta menyebut penyematannya responsif, dan maxwidth menentukan lebar maksimumnya.
Bisakah saya menyematkan profil Instagram?
Ya. Panduan Meta mencantumkan URL profil, https://www.instagram.com/{username}, sebagai salah satu format yang diterima parameter url.
Bisakah saya memakai data oEmbed untuk analitik?
Tidak. Meta hanya mengizinkan endpoint ini untuk menampilkan postingan di halaman atau aplikasi, dan melarang penggunaan lain atas metadata serta kontennya.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada