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

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.

10,000

Cele mai recente postări create pe care edge-ul media le returnează cel mult, conform referinței Meta IG User Media.

since, until

Parametrii de paginare pe bază de timp ai edge-ului media, care primesc timestamp-uri Unix sau valori strtotime.

/stories

Unde se citesc Stories: edge-ul media nu returnează conținut Stories.

VIDEO only

Tipul de media care returnează thumbnail_url, URL-ul miniaturii conținutului.

Optional

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.

Listing posts with their main fields
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:

idThe media's ID
media_typeCAROUSEL_ALBUM, IMAGE or VIDEO
media_urlThe image or video file; left out for some videos
thumbnail_urlA thumbnail image, on VIDEO media only
permalinkThe post's permanent URL; not on carousel items
timestampCreation date, ISO 8601 in UTC
shortcodeThe post's shortcode
usernameThe account that created the post
comments_count, like_countCounts; like_count is left out when the owner hides likes
alt_textDescriptive text for an image
is_comment_enabledWhether comments are turned on
caption, media_product_typeMarked Facebook Login only in Meta's reference

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.

A carousel's items
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.
Faceți acest lucru cu EasyCoexistence

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