Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Ghid Instagram API pentru 2026: de la aplicația ta la prima postare

În 2026, Instagram API duce o aplicație până la prima postare în șase pași: un cont profesional, o configurare a logării, o aplicație Meta, permisiuni cu nivelul de acces potrivit, un token de acces, apoi un container media creat cu POST /<IG_ID>/media și publicat cu media_publish. Comentariile, DM-urile, webhook-urile, statisticile și limitele Meta vin după. Pentru aplicațiile noi, Meta recomandă Unified Login.

easyCoexistence transformă pașii 2 până la 5 într-o singură autentificare cu Instagram: aplicația sa Meta rulează logarea, reînnoiește token-ul înainte de expirare și verifică contul la fiecare 6 ore, iar Claude, ChatGPT sau propria ta platformă publică, programează, răspunde la comentarii și DM-uri și citește statisticile prin API-ul oficial al Meta.

3 setups

Unified Login, recomandat pentru integrările noi, plus Instagram Login și Facebook Login, păstrate pentru cele existente.

New apps

Aplicațiile Meta create recent nu pot configura Instagram API cu Instagram Login, spune ghidul de migrare al Meta.

60 days

Cât durează un token de acces Instagram User cu durată lungă; reîmprospătarea este posibilă după ce are 24 de ore.

100 posts

Postările publicate prin API pe care un cont le poate face într-o perioadă glisantă de 24 de ore, un carusel contând ca unul.

2 to 3 days

Cât durează, de regulă, App Review, conform Meta; de obicei, o trimitere este procesată în mai puțin de o săptămână.

Care sunt pașii de la o aplicație nouă până la prima postare?

Șase pași duc până la prima postare, iar alți patru definesc ce face aplicația după aceea. Contul trebuie să fie profesional, aplicația alege una dintre cele trei configurări de logare ale Meta, titularul contului acordă permisiunile, iar serverul aplicației păstrează un token. Publicarea înseamnă apoi două apeluri. Comentariile, DM-urile, webhook-urile, statisticile și limitele urmează, iar ultimele secțiuni indică pagina care acoperă fiecare pas în întregime.

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

Pasul 1: ce cont de Instagram funcționează cu API-ul?

Un cont profesional, de business sau de creator. Instagram Platform al Meta servește doar conturile profesionale, iar ambele tipuri funcționează la fel pentru publicare, comentarii, DM-uri și statistici. Un cont personal se trece din aplicația Instagram, la Tipul contului și instrumentele, iar unul privat devine public odată cu schimbarea. Instagram Login și Unified Login nu cer o Pagină asociată, în timp ce Facebook Login cere una.

Pasul 2: ce configurare de logare ar trebui să folosească aplicația?

Meta documentează trei, iar alegerea fixează gazda, token-ul și numele permisiunilor. Prezentarea generală recomandă Unified Login pentru integrările noi, pagina sa despre Unified Login spune că noile funcții ale Instagram API sunt lansate doar acolo, iar ghidul de migrare spune că aplicațiile nou create nu pot configura Instagram Login. Integrările existente cu Instagram Login continuă să funcționeze, fără o dată de încheiere anunțată.

  • Unified Login: clientul se autentifică cu Instagram sau prin Facebook Login, alege un portofoliu de business, iar aplicația primește un token Business Integration System User.
  • Instagram Login: titularul se autentifică cu Instagram, iar apelurile merg la graph.instagram.com cu un token Instagram User și permisiunile instagram_business_*.
  • Facebook Login: contul trebuie să fie asociat unei Pagini pe care persoana o poate administra, cu permisiunile instagram_* și cele pentru Pagină.

Pasul 3: cum se creează aplicația Meta?

În App Dashboard, pe un drum care depinde de configurare. Ghidul Unified Login al Meta pornește de la o aplicație cu cazul de utilizare Manage messaging & content on Instagram, deținută de un portofoliu de business. Sub API setup with Unified login, aplicația creează o configurație, al cărei config_id numește permisiunile și resursele de cerut, salvează un URL de redirecționare HTTPS și copiază URL-ul de logare. O aplicație Instagram Login existentă păstrează API setup with Instagram login, unde se află ID-ul și secretul aplicației Instagram.

Pasul 4: ce permisiuni și ce nivel de acces are nevoie aplicația?

O permisiune pentru fiecare funcție, acordată de titularul contului la autentificare. Unified Login folosește familia instagram_*, precum instagram_content_publish și instagram_manage_comments, iar Instagram Login numele instagram_business_*. Standard Access, implicit, acoperă conturile pe care le deții sau le administrezi și persoanele cu un rol în aplicație. Deservirea conturilor altor afaceri necesită Advanced Access, acordat permisiune cu permisiune prin App Review, cu Business Verification.

Pasul 5: cum obține aplicația un token de acces?

Din autentificarea titularului, schimbat pe server și niciodată într-un browser sau o aplicație mobilă. Cu Instagram Login, redirecționarea aduce un cod valabil o oră și utilizabil o singură dată; el devine un token cu durată scurtă, apoi unul cu durată lungă, de 60 de zile, care poate fi reîmprospătat după ce are o zi. Cu Unified Login, codul devine un token Business Integration System User, a cărui expirare depinde de configurație.

Pasul 6: cum publici prima postare?

Cu două apeluri. POST /<IG_ID>/media cu un image_url public, pe care Meta îl preia singură, creează un container; POST /<IG_ID>/media_publish cu ID-ul containerului ca creation_id îl publică și returnează ID-ul media. Imaginile trebuie să fie JPEG. Pentru un Reel sau alt videoclip, verifică status_code-ul containerului până ce indică FINISHED, întrucât publicarea mai devreme eșuează.

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>" }

Pasul 7: cum funcționează comentariile și DM-urile?

Amândouă pornesc de la altcineva. GET /<IG_MEDIA_ID>/comments returnează până la 50 de comentarii de nivel superior per cerere, POST /<IG_COMMENT_ID>/replies răspunde unuia public, iar un răspuns privat trimite comentatorului un singur DM în 7 zile de la comentariu. DM-urile merg către persoanele care au scris primele, într-o fereastră standard de 24 de ore pentru majoritatea acțiunilor, după ce titularul activează Allow access to messages în aplicația Instagram.

Pasul 8: cum spun webhook-urile aplicației ce s-a întâmplat?

Meta trimite JSON către un endpoint HTTPS, care se dovedește o singură dată repetând hub.challenge, și semnează fiecare eveniment în X-Hub-Signature-256 cu un HMAC-SHA256 al payload-ului, folosind secretul aplicației drept cheie. Aplicația selectează câmpuri precum comments și messages în App Dashboard, apoi abonează fiecare cont prin muchia subscribed_apps. Notificările ajung doar la aplicațiile Live, iar notificările de comentarii cer Advanced Access.

Pasul 9: cum citește aplicația statisticile?

Din două muchii: GET /<IG_ID>/insights pentru cont și GET /<IG_MEDIA_ID>/insights pentru o postare, un Reel sau o Story. Metricile contului, precum reach, views și accounts_engaged, iau period=day cu metric_type=total_value. views a înlocuit impressions în 2025, unele metrici cer cel puțin 100 de urmăritori, iar Meta notează că datele pot întârzia până la 48 de ore.

Pasul 10: ce limite modelează aplicația?

Meta stabilește principalele limite per cont, astfel încât un cont nou aduce propria cotă în loc să o împartă cu altul:

  • Apeluri: de 4.800 de ori numărul de impressions ale contului într-un interval glisant de 24 de ore, per aplicație și cont, fără mesageria.
  • Publicare: 100 de postări publicate prin API și 400 de containere media per cont în 24 de ore.
  • Mesagerie: 100 de apeluri Send API pe secundă pentru text și 750 de răspunsuri private pe oră la postări și Reel-uri.
  • Containere: unul rămas nepublicat 24 de ore expiră și trebuie creat din nou.

Ce pagină acoperă fiecare pas în detaliu?

Fiecare pas are propria pagină de referință în aceste documente, cu câmpurile, erorile și cazurile limită pe care ghidul acesta le omite. Căile de mai jos stau sub adresa site-ului, iar pagina de cod arată apelurile de publicare, comentarii, statistici și webhook în Python și Node.js, unul lângă celălalt:

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

Care este calea prin easyCoexistence?

O singură autentificare în locul pașilor 2 până la 5 și al configurării webhook-urilor. În dashboard-ul easyCoexistence, alegi New connection, apoi Instagram, te autentifici cu contul Business sau Creator și aprobi cele cinci permisiuni instagram_business_*; aplicația Meta a easyCoexistence rulează logarea, reînnoiește token-ul și verifică contul la fiecare 6 ore. Claude, ChatGPT sau propriul tău agent lucrează apoi prin https://easycoexistence.com/api/mcp, propriul cod poate lua ID-ul contului și baza API din get_social_credentials, iar postările pot fi programate cu până la 90 de zile înainte din coada easyCoexistence.

Greșeli frecvente

  • Pornirea unei aplicații noi pe Instagram Login. Ghidul de migrare al Meta spune că aplicațiile nou create nu pot configura asta, iar prezentarea generală recomandă Unified Login pentru integrările noi.
  • Apelarea unei integrări Unified Login cu un token Instagram User. Ghidul webhook al Meta spune că acele token-uri și graph.instagram.com nu funcționează cu Unified Login.
  • Publicarea imediată a unui container video. media_publish eșuează cu subcodul 2207027 până când status_code-ul containerului indică FINISHED.
  • Interogarea periodică pentru comentarii și DM-uri. Meta recomandă webhook-uri, care reduc apelurile făcute de aplicație și riscul de limitare a ratei.
Faceți acest lucru cu EasyCoexistence

US$ 9 până la US$ 0.75 per conexiune pe lună, scăzând pe măsură ce adaugi conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Cât durează să obții acces la Instagram API?

Pentru conturile pe care le deții sau le administrezi, nu există așteptare: Standard Access funcționează de la început. Deservirea altor afaceri necesită App Review, care, spune Meta, durează de regulă mai puțin de o săptămână, și Business Verification.

Poate o aplicație Meta nouă să folosească încă Instagram Login?

Nu, conform ghidului de migrare al Meta, care spune că aplicațiile nou create nu o pot configura. Integrările existente cu Instagram Login continuă să funcționeze, iar Meta nu a anunțat nicio dată de încheiere.

Poate API-ul să publice un fișier de pe computerul meu?

Nu cu Instagram Login, unde Meta preia fiecare imagine sau videoclip de la un URL public. Meta documentează încărcările reluabile, care acceptă un fișier video local, pentru configurările construite pe Facebook Login for Business, inclusiv Unified Login.

Cât costă easyCoexistence pentru un cont de Instagram?

Fiecare cont de Instagram este o conexiune: US$ 9 până la US$ 0.75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la