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

2026'da Instagram API rehberi: uygulamanızdan ilk gönderiye

2026'da Instagram API, bir uygulamayı altı adımda ilk gönderiye ulaştırır: profesyonel bir hesap, bir giriş kurulumu, bir Meta uygulaması, doğru erişim düzeyinde izinler, bir erişim token'ı ve ardından POST /<IG_ID>/media ile oluşturulan ve media_publish ile yayımlanan bir medya konteyneri. Yorumlar, DM'ler, webhook'lar, insights ve Meta'nın limitleri bunlardan sonra gelir. Yeni uygulamalar için Meta, Unified Login kullanımını önerir.

easyCoexistence, adım 2'den 5'e kadar olanları Instagram ile tek bir oturum açmaya dönüştürür: Meta uygulaması girişi yürütür, token dolmadan önce yeniler ve hesabı her 6 saatte bir kontrol eder; Claude, ChatGPT ya da kendi platformunuz ise Meta'nın resmi API'si üzerinden yayımlar, zamanlar, yorumlara ve DM'lere yanıt verir ve insights okur.

3 setups

Yeni entegrasyonlar için önerilen Unified Login ile birlikte, mevcut olanlar için tutulan Instagram Login ve Facebook Login.

New apps

Meta'nın geçiş kılavuzuna göre, yeni oluşturulan Meta uygulamaları Instagram API'yi Instagram Login ile kuramaz.

60 days

Uzun ömürlü bir Instagram User erişim token'ının ne kadar süre geçerli olduğu; 24 saatlik olduktan sonra yenilenebilir.

100 posts

Bir hesabın 24 saatlik kayan bir dönemde API ile yayımlayabileceği gönderi sayısı; karusel tek sayılır.

2 to 3 days

Meta'nın hesabına göre App Review'un genellikle ne kadar sürdüğü; Meta bir başvuruyu genellikle bir haftadan kısa sürede işler.

Yeni bir uygulamadan ilk gönderiye giden adımlar nelerdir?

İlk gönderiye altı adım götürür, uygulamanın ondan sonra ne yaptığını ise dört adım daha belirler. Hesabın profesyonel olması gerekir, uygulama Meta'nın üç giriş kurulumundan birini seçer, hesap sahibi izinleri verir ve uygulamanın sunucusu bir token tutar. Yayımlama ardından iki çağrıdan oluşur. Yorumlar, DM'ler, webhook'lar, insights ve limitler sırayla gelir; son bölümler her adımı tam olarak kapsayan sayfayı gösterir.

1Professional accountBusiness or Creator, switched in the Instagram app
2Login setupUnified Login for new apps, Instagram Login for existing ones
3Meta app and permissionsStandard Access to test, Advanced Access through App Review
4Access tokenFrom the owner's sign-in, kept on the server
5First postPOST /<IG_ID>/media, then media_publish

Adım 1: API ile hangi Instagram hesabı çalışır?

Profesyonel bir hesap: işletme ya da içerik üreticisi. Meta'nın Instagram Platform'u yalnızca profesyonel hesaplara hizmet verir; her iki tür de yayımlama, yorumlar, DM'ler ve insights için aynı şekilde çalışır. Kişisel bir hesap Instagram uygulamasında, Hesap türü ve araçlar altında geçilir; gizli bir hesap da bunu yaptığında herkese açık olur. Instagram Login ve Unified Login bağlı bir Sayfa gerektirmez, Facebook Login ise gerektirir.

Adım 2: uygulama hangi giriş kurulumunu kullanmalı?

Meta üç kurulum tanımlar; seçim ana makineyi, token'ı ve izin adlarını belirler. Genel bakışı yeni entegrasyonlar için Unified Login'i önerir, Unified Login sayfası yeni Instagram API özelliklerinin yalnızca orada yayımlandığını söyler ve geçiş kılavuzu yeni oluşturulan uygulamaların Instagram Login'i kuramayacağını belirtir. Mevcut Instagram Login entegrasyonları, bitiş tarihi açıklanmadan çalışmaya devam eder.

  • Unified Login: istemci Instagram ile ya da Facebook Login üzerinden oturum açar, bir Business Portfolio seçer ve uygulama bir Business Integration System User token'ı alır.
  • Instagram Login: sahip Instagram ile oturum açar, çağrılar bir Instagram User token'ı ve instagram_business_* izinleriyle graph.instagram.com'a gider.
  • Facebook Login: hesap, kişinin yönetebildiği bir Sayfaya bağlı olmalıdır; instagram_* ve Sayfa izinleri gerekir.

Adım 3: Meta uygulaması nasıl oluşturulur?

App Dashboard'da, kurulumuna bağlı bir yolla. Meta'nın Unified Login kılavuzu, bir Business Portfolio'ya ait ve Manage messaging & content on Instagram kullanım senaryosuna sahip bir uygulamadan başlar. API setup altında Unified login ile uygulama bir yapılandırma oluşturur; bu yapılandırmanın config_id'si istenecek izinleri ve varlıkları adlandırır, bir HTTPS yönlendirme URL'si kaydeder ve giriş URL'sini kopyalar. Mevcut bir Instagram Login uygulaması, Instagram uygulama kimliği ve gizli anahtarının bulunduğu API setup with Instagram login'i korur.

Adım 4: uygulamanın hangi izinlere ve erişim düzeyine ihtiyacı var?

Her özellik için bir izin, hesap sahibi tarafından oturum açarken verilir. Unified Login, instagram_content_publish ve instagram_manage_comments gibi instagram_* ailesini kullanır; Instagram Login ise instagram_business_* adlarını. Varsayılan olan Standard Access, sahibi veya yöneticisi olduğunuz hesapları ve uygulamada rolü bulunan kişileri kapsar. Başka işletmelerin hesaplarına hizmet vermek, her izni ayrı ayrı App Review üzerinden ve Business Verification ile alan Advanced Access gerektirir.

Adım 5: uygulama erişim token'ını nasıl alır?

Sahibin oturum açmasından alınır, sunucuda değiş tokuş edilir ve asla tarayıcıda ya da mobil uygulamada işlenmez. Instagram Login'de yönlendirme, yalnızca bir kez kullanılabilen ve bir saat geçerli bir kod taşır; bu kod önce kısa ömürlü bir token'a, sonra 60 gün geçerli olan uzun ömürlü bir token'a dönüşür ve bu token bir günlük olduğunda yenilenebilir. Unified Login ile kod bir Business Integration System User token'ına dönüşür; bunun süresi yapılandırmaya bağlıdır.

Adım 6: ilk gönderi nasıl yayımlanır?

İki çağrıyla. Meta'nın kendisi çekeceği herkese açık bir image_url ile POST /<IG_ID>/media bir konteyner oluşturur; bu konteynerin ID'si creation_id olarak verilerek POST /<IG_ID>/media_publish çağrısı onu yayımlar ve medya ID'sini döndürür. Görseller JPEG olmalıdır. Reel ya da başka bir video için konteynerin status_code değeri FINISHED olana kadar kontrol edin, çünkü daha önce yayımlama başarısız olur.

A first photo post with Instagram Login
POST https://graph.instagram.com/v26.0/<IG_ID>/media
  ?image_url=https://www.example.com/images/first-post.jpg
  &caption=Hello%20from%20the%20API
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_CONTAINER_ID>" }

POST https://graph.instagram.com/v26.0/<IG_ID>/media_publish
  ?creation_id=<IG_CONTAINER_ID>
  &access_token=<ACCESS_TOKEN>

{ "id": "<IG_MEDIA_ID>" }

Adım 7: yorumlar ve DM'ler nasıl çalışır?

İkisi de başkasıyla başlar. GET /<IG_MEDIA_ID>/comments istek başına en fazla 50 üst düzey yorum döndürür, POST /<IG_COMMENT_ID>/replies birine herkese açık olarak yanıt verir ve özel bir yanıt, yorumcuya yorumdan itibaren 7 gün içinde tek bir DM gönderir. DM'ler önce yazan kişilere gider; çoğu eylem için standart 24 saatlik pencere içinde, hesap sahibi Instagram uygulamasında Allow access to messages seçeneğini açtığında.

Adım 8: webhook'lar uygulamaya ne olduğunu nasıl bildirir?

Meta, bir HTTPS uç noktasına JSON POST eder; uç nokta hub.challenge değerini geri yansıtarak bir kez kendini kanıtlar ve her olayı, payload'un uygulama gizli anahtarıyla üretilmiş bir HMAC-SHA256 özetiyle X-Hub-Signature-256 başlığında imzalar. Uygulama, App Dashboard'da yorumlar ve mesajlar gibi alanları seçer, sonra her hesabı subscribed_apps kenarı üzerinden abone eder. Bildirimler yalnızca Live uygulamalara ulaşır ve yorum bildirimleri Advanced Access gerektirir.

Adım 9: uygulama insights verilerini nasıl okur?

İki kenardan: hesap için GET /<IG_ID>/insights ve bir gönderi, Reel ya da Story için GET /<IG_MEDIA_ID>/insights. Ulaşım, görüntülenme ve accounts_engaged gibi hesap metrikleri period=day ve metric_type=total_value ile gelir. views, 2025'te impressions'ın yerini aldı; bazı metrikler en az 100 takipçi gerektirir ve Meta, verilerin 48 saate kadar gecikebileceğini belirtir.

Adım 10: uygulamayı hangi limitler şekillendirir?

Meta ana limitlerini hesap başına belirler; bu nedenle yeni bir hesap, ortak bir havuz yerine kendi payını getirir:

  • Çağrılar: uygulama ve hesap başına, mesajlaşma hariç, kayan 24 saatte hesabın gösterim sayısının 4.800 katı.
  • Yayımlama: hesap başına 24 saatte 100 API ile yayımlanan gönderi ve 400 medya konteyneri.
  • Mesajlaşma: metin için saniyede 100 Send API çağrısı; gönderilerde ve Reel'lerde saatte 750 özel yanıt.
  • Konteynerler: 24 saat yayımlanmadan kalan bir konteyner sona erer ve yeniden oluşturulmalıdır.

Her adımı ayrıntılı olarak hangi sayfa kapsar?

Her adımın bu dokümanlarda kendi referans sayfası var; bu rehberin dışarıda bıraktığı alanlar, hatalar ve uç durumlar orada yer alır. Aşağıdaki yollar sitenin adresinin altında yer alır; kod sayfası ise yayımlama, yorum, insights ve webhook çağrılarını Python ve Node.js'te yan yana gösterir:

Account type/docs/instagram/business-or-creator-account
Login setups/docs/instagram/unified-login
Meta app and access/docs/instagram/api-access, /docs/instagram/app-review
Permissions/docs/instagram/api-permissions
Tokens/docs/instagram/access-tokens
Code/docs/instagram/api-python-node
Publishing/docs/instagram/publishing-limits
Webhooks/docs/instagram/webhook-events
Insights/docs/instagram/insights-metrics
Limits/docs/instagram/api-rate-limits
When it stops working/docs/instagram/connection-lost

easyCoexistence üzerinden yol nasıl ilerler?

Adım 2'den 5'e ve webhook kurulumu yerine tek bir oturum açma. Panelde Yeni bağlantı'yı seçin, Instagram'ı seçin, Business ya da Creator hesabıyla oturum açın ve beş instagram_business_* iznini onaylayın; easyCoexistence'ın Meta uygulaması girişi yürütür, token'ı yeniler ve hesabı her 6 saatte bir kontrol eder. Claude, ChatGPT ya da kendi ajanınız https://easycoexistence.com/api/mcp üzerinden çalışır, kendi kodunuz hesabın ID'sini ve API temel adresini get_social_credentials'tan alabilir ve gönderiler easyCoexistence'ın kuyruğundan 90 güne kadar önceden zamanlanabilir.

Yaygın hatalar

  • Yeni bir uygulamayı Instagram Login ile başlatmak. Meta'nın geçiş kılavuzu, yeni oluşturulan uygulamaların bunu kuramayacağını söylüyor; genel bakış ise yeni entegrasyonlar için Unified Login'i öneriyor.
  • Bir Unified Login entegrasyonunu bir Instagram User token'ıyla çağırmak. Meta'nın webhook kılavuzu, bu token'ların ve graph.instagram.com'un Unified Login ile çalışmadığını söylüyor.
  • Bir video konteynerini hemen yayımlamak. status_code FINISHED olana kadar media_publish, 2207027 alt koduyla başarısız olur.
  • Yorumlar ve DM'ler için sorgu yapmak. Meta webhook'ları önerir; bunlar bir uygulamanın yaptığı çağrıları ve hız sınırına takılma riskini azaltır.
Bunu EasyCoexistence'la yapmak

Bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar, bağlantı sayısı arttıkça düşen bir fiyatla; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Instagram API erişimi almak ne kadar sürer?

Sahibi veya yöneticisi olduğunuz hesaplar için bekleme yok: Standard Access baştan çalışır. Başka işletmelere hizmet vermek ise App Review gerektirir; Meta bunun genellikle bir haftadan kısa sürdüğünü söylüyor, ayrıca Business Verification de gerekir.

Yeni bir Meta uygulaması hâlâ Instagram Login kullanabilir mi?

Meta'nın geçiş kılavuzuna göre hayır; yeni oluşturulan uygulamalar bunu kuramaz. Mevcut Instagram Login entegrasyonları çalışmaya devam eder ve Meta bir bitiş tarihi açıklamadı.

API bilgisayarımdaki bir dosyayı yayımlayabilir mi?

Instagram Login ile hayır; burada Meta her görseli ya da videoyu herkese açık bir URL'den çeker. Meta, Unified Login dahil, Facebook Login for Business üzerine kurulu kurulumlar için yerel bir video dosyasını kabul eden devam ettirilebilir yüklemeleri belgeliyor.

Bir Instagram hesabı için easyCoexistence ne kadar tutar?

Her Instagram hesabı bir bağlantıdır: bağlantı başına ayda US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.

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