Obținerea postărilor unui cont Instagram prin API
GET /<IG_ID>/media returnează postările unui cont profesional Instagram ca obiecte IG Media, cel mult cele 10.000 cele mai recent create. Cereți câmpuri precum id, media_type, media_url, permalink, thumbnail_url și timestamp, iar elementele unui carusel le citiți prin children. Răspunsurile includ cursoarele before și after pentru paginare, iar since și until le limitează după dată. Cu Instagram Login, cererea merge la graph.instagram.com.
easyCoexistence listează postările unui cont Instagram conectat cu list_social_posts, câte 1 până la 100 deodată, din Claude, ChatGPT sau propriul cod, prin API-ul oficial Meta, cu token-ul adăugat.
Cele mai recente postări create pe care edge-ul media le returnează cel mult, conform referinței Meta IG User Media.
Parametrii de paginare pe bază de timp ai edge-ului media, care primesc timestamp-uri Unix sau valori strtotime.
Unde se citesc Stories: edge-ul media nu returnează conținut Stories.
Tipul de media care returnează thumbnail_url, URL-ul miniaturii conținutului.
Cum recomandă Meta să tratați media_url, pe care îl omite la unele videoclipuri; folosiți permalink sau thumbnail_url drept rezervă.
Cum obțineți postările unui cont?
Printr-un GET pe edge-ul media al contului, indicând câmpurile dorite; fără fields, exemplul Meta returnează doar id-ul fiecărei postări. Cu Instagram Login, cererea merge la graph.instagram.com cu token-ul de acces Instagram User care are instagram_business_basic, iar răspunsul listează postările în data, cu un obiect paging pentru pagina următoare.
GET https://graph.instagram.com/<IG_ID>/media
?fields=id,media_type,media_url,permalink,thumbnail_url,timestamp
&limit=25
&access_token=<ACCESS_TOKEN>
{
"data": [
{
"id": "<IG_MEDIA_ID>",
"media_type": "IMAGE",
"media_url": "<CDN_URL>",
"permalink": "https://www.instagram.com/p/<SHORTCODE>/",
"timestamp": "2026-10-30T14:02:11+0000"
}
],
"paging": {
"cursors": { "before": "<CURSOR>", "after": "<CURSOR>" },
"next": "<NEXT_PAGE_URL>"
}
}Ce câmpuri poate returna fiecare postare?
Cele ale obiectului IG Media, enumerate în referința Meta; cereți doar pe cele pe care le folosiți. Două rânduri din referință, caption și media_product_type, au nota Available for Instagram API with Facebook Login only, deci verificați-le față de configurarea dumneavoastră înainte de a vă baza pe ele:
Cum funcționează paginarea?
Prin cursoare. Obiectul paging conține cursoarele before și after și, cât timp mai sunt rezultate, un URL next; ghidul Graph API al Meta spune să vă opriți când next nu mai apare, pentru că o pagină poate avea mai puține elemente decât cere limit. Edge-ul media pagina și după timp: since și until primesc timestamp-uri Unix sau valori strtotime și păstrează rezultatele în intervalul respectiv.
Cum citiți fotografiile și videoclipurile unui carusel?
Prin edge-ul children. O postare al cărei media_type este CAROUSEL_ALBUM își listează elementele cu GET /<IG_MEDIA_ID>/children, folosind același token și aceeași permisiune ca edge-ul media, iar fiecare element este un obiect IG Media cu propriul id, media_type și media_url. Meta notează că unele câmpuri, printre care permalink, nu pot fi folosite pentru fotografiile dintr-un album.
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
?fields=id,media_type,media_url
&access_token=<ACCESS_TOKEN>De ce lipsește media_url la unele postări?
Meta îl omite pentru videoclipurile care conțin audio cu drepturi de autor sau licențiat, inclusiv melodii din biblioteca audio Instagram, și pentru conținutul marcat pentru încălcarea drepturilor de autor, chiar și la postările proprii ale contului. Referința spune să tratați media_url ca opțional și să folosiți permalink sau thumbnail_url drept rezervă. Un video Live poate fi citit doar cât timp este transmis în direct.
Cum afișați postările pe un site web?
De pe serverul dumneavoastră, cu token-ul de lungă durată al contului, care are valabilitate de 60 de zile și trebuie reînnoit înainte de expirare. Legați fiecare plăcuță de permalink-ul ei și reîmprospătați lista periodic: Meta servește conținutul prin URL-uri CDN conștiente de confidențialitate, care nu mai returnează un fișier după ce conținutul a fost șters sau a expirat. Pentru a afișa o postare așa cum o desenează Instagram, transmiteți permalink-ul ei către endpoint-ul oEmbed.
Cum listați postările prin easyCoexistence?
Cu list_social_posts, care primește account_id și un limit de la 1 la 100, implicit 25, și returnează postările recente ale contului cu ID-urile lor, tipurile de media, URL-urile media, miniaturile, permalink-urile, timestamp-urile și numărul de aprecieri și comentarii. Citește cele mai recente postări, până la 100, și nu are cursor pentru pagini suplimentare sau alte câmpuri.
Greșeli frecvente
- Căutarea Stories în edge-ul media. Meta le omite; GET /<IG_ID>/stories le returnează în cele 24 de ore cât durează.
- Construirea unui flux doar pe media_url. Meta îl omite pentru unele videoclipuri, deci păstrați permalink sau thumbnail_url drept rezervă.
- Cererea permalink pe elementele unui carusel. Meta nu îl returnează pentru fotografiile dintr-un album, deci legați la postarea părinte.
- Tratarea unei pagini scurte drept ultima. O pagină poate avea mai puține elemente decât limit; opriți-vă doar când paginarea nu mai are next.
De la US$ 9 până la US$ 0,75 per conexiune pe lună, care scade pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Câte postări poate returna API-ul Instagram?
Până la cele 10.000 cele mai recent create, câte o pagină deodată din edge-ul media. Stories vin din edge-ul separat stories cât timp durează.
Include edge-ul media și Reels?
Da. Un Reel este un obiect IG Media ca o fotografie, raportat cu media_type VIDEO; Stories sunt ce lasă afară edge-ul media.
Pot obține postările altui cont?
Nu din edge-ul media, care citește contul din spatele token-ului. Business Discovery returnează postările altui cont de firmă sau de creator, cu Facebook Login sau Unified Login.
De ce a încetat să funcționeze un media_url vechi?
URL-urile CDN ale Meta sunt conștiente de confidențialitate: nu mai returnează conținut după ce acesta a fost șters sau a expirat, deci cereți URL-uri actuale când aveți nevoie de ele.
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