Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

oEmbed ile Instagram gönderilerini bir web sitesine gömme

Meta'nın Instagram oEmbed uç noktası, GET /instagram_oembed?url=<POST_URL> isteğiyle, herkese açık bir Instagram gönderisini veya Reel'i bir web sayfasına gömen HTML'i; version, provider_name, provider_url, type ve width alanlarıyla birlikte döndürür. 15 Mayıs 2026'dan itibaren erişim token'ı olmadan çağrılabilir ve gömme HTML'i, gönderiyi çizmek için Instagram'ın embed.js dosyasını yükler.

easyCoexistence, bağlı her Instagram gönderisinin kalıcı bağlantısını list_social_posts üzerinden döndürür; bu bağlantı oEmbed'e hazır biçimde geçirilebilir.

15 May 2026

Bu tarihten itibaren Meta'nın Instagram oEmbed API'si, tüm sürümlerde erişim token'ı olmadan çağrılabilir.

1,000/hour

Meta'nın oEmbed kılavuzunun izin verdiği saatlik istek sayısı.

320 to 658

maxwidth'in kabul ettiği aralık; maxheight desteklenmez.

3 Nov 2025

author_name, author_url ve küçük resim alanlarının tüm API sürümlerindeki Instagram oEmbed yanıtlarından çıktığı tarih.

Stories

oEmbed uç noktası tarafından desteklenmez; özel, etkin olmayan veya yaş sınırlı hesapların gönderileri de desteklenmez.

Instagram'ın oEmbed uç noktası nasıl çalışır?

Herkese açık bir gönderinin URL'sini gönderir ve onu gösteren HTML'i geri alırsınız. Uç nokta, Facebook Login çağrılarının kullandığı Meta'nın ana Graph API sunucusunda çalışır; graph.instagram.com'da değil. Yanıt, html alanı olduğu gibi sayfaya konulabilen küçük bir JSON nesnesidir.

A request and its response
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>"
}

Hangi URL'leri kabul eder?

Meta'nın kılavuzu, url parametresi için üç biçim listeler; bu biçimler düz veya URL kodlamalı gönderilebilir. Kılavuzdaki iki örnek istek bunlardan birer tane gösterir:

  • Tek görsel ve karusel gönderileri: https://www.instagram.com/p/{media-shortcode}/
  • Videolar ve Reel'ler: https://www.instagram.com/reel/{media-shortcode}/
  • Profiller: https://www.instagram.com/{username}

Erişim token'ı gerekir mi?

15 Mayıs 2026'dan beri gerekmez. Meta'nın changelog'una göre Instagram oEmbed API o tarihten itibaren token olmadan çağrılabilir hale geldi. Bundan önce uygulamaların App Review üzerinden Meta oEmbed Read özelliğine ihtiyacı vardı ve her çağrıda token gerekiyordu; token ile erişim hâlâ çalışır. Meta'nın oEmbed kılavuzu saatte en fazla 1.000 istek sağlar; token olmadan erişim duyurusunda ise token kullanan uygulamaların daha yüksek hız sınırları alabileceği belirtildi.

Hangi parametreleri alır?

url dışında dört parametre; Meta'nın kılavuzu ve başvuru belgesine göre:

  • maxwidth: 320 ile 658 arası; gömme aksi halde duyarlıdır, maxheight ise desteklenmez.
  • hidecaption: true, gönderinin açıklamasını gizler; varsayılan değeri false'tır.
  • omitscript: true, betiği HTML'den çıkarır; embed.js dosyasını bir kez kendisi yükleyen ve instgrm.Embeds.process() çağıran sayfalar için kullanılır.
  • fields: yanıtı adı verilen alanlarla sınırlar.

Yanıt neleri içerir?

Varsayılan altı alan vardır: html, gösterilecek işaretleme; version, her zaman 1.0; provider_name ve provider_url, sağlayıcı olarak Instagram'ı belirtir; type, oEmbed kaynak türü; ve width, piksel cinsinden genişlik. Meta, 3 Kasım 2025'te author_name, author_url, thumbnail_url, thumbnail_width ve thumbnail_height alanlarını tüm API sürümlerinde Instagram gönderisi yanıtlarından kaldırdı. Kendi hesabınızın gönderileri için media edge'i yine username, permalink ve thumbnail_url döndürür.

Neler gömülemez?

Meta'nın kılavuzu, uç noktanın dışında bıraktıklarını ve kullanımla ilgili bir kuralı listeler:

  • Özel, etkin olmayan ve yaş sınırlı hesaplardaki gönderiler.
  • Gömmeyi kapatmış hesaplar.
  • Hikâyeler ve gömmeyi Shadow DOM içinde gösteren sayfalar.
  • Ön yüz görünümünün ötesindeki her kullanım: Meta, uç noktanın meta verilerinin veya içeriğinin başka amaçlarla kullanılmasını kesinlikle yasaklar.

Kendi hesabınızın gönderilerini nasıl gömersiniz?

Her gönderinin kalıcı bağlantısını (permalink) alıp url olarak gönderin. easyCoexistence üzerinden list_social_posts, bağlı hesabın son gönderilerini kalıcı bağlantılarıyla döndürür; bu, Claude, ChatGPT veya kendi kodunuzdan çağrılabilir. oEmbed çağrısı token gerektirmediği için sitenizden doğrudan yapılabilir.

Yaygın hatalar

  • Hikâye bağlantısı göndermek. Meta'nın oEmbed uç noktası hikâyeleri desteklemez; bu yüzden bir gönderi veya Reel gömün.
  • Yanıttan thumbnail_url okumak. Meta bunu, author_name ve diğer küçük resim alanlarıyla birlikte 3 Kasım 2025'te kaldırdı.
  • maxwidth'i 320'nin altına veya 658'in üstüne ayarlamak. Meta yalnızca bu aralıktaki değerleri kabul eder; maxheight ise hiç desteklenmez.
  • Her gömmede embed.js dosyasını yüklemek. omitscript true iken betiği bir kez yükleyin ve instgrm.Embeds.process() çağırın.
Bunu EasyCoexistence'la yapmak

Claude, ChatGPT veya kendi kodunuz da Meta'nın resmi API'si üzerinden hesapta gönderi yayımlayabilir, planlayabilir ve yorumlara ile DM'lere yanıt verebilir. Bağlantı başına ayda US$ 9'dan US$ 0,75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Instagram Reel'i gömebilir miyim?

Evet. Reel'in https://www.instagram.com/reel/{media-shortcode}/ URL'sini gönderin; uç nokta gömme HTML'ini döndürür.

Instagram gömmesi duyarlı mı?

Evet. Meta'nın kılavuzu gömmenin duyarlı olduğunu belirtir; maxwidth, gömmenin alabileceği en geniş genişliği belirler.

Bir Instagram profilini gömebilir miyim?

Evet. Meta'nın kılavuzu, url parametresinin kabul ettiği biçimler arasında profil URL'lerini, https://www.instagram.com/{username} biçimini listeler.

oEmbed verilerini analiz için kullanabilir miyim?

Hayır. Meta, uç noktayı yalnızca gönderiyi bir sayfada veya uygulamada göstermek için izin verir; meta verilerinin ve içeriğinin diğer kullanımlarını yasaklar.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi