Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Instagram API u Python i Node.js: radni primeri

Instagram API ne traži ništa osim HTTPS-a, pa requests u Pythonu i ugrađeni fetch u Node.js-u pokrivaju sve: POST /<IG_ID>/media, a zatim media_publish objavljuje, /<IG_MEDIA_ID>/comments i /<IG_COMMENT_ID>/replies čitaju i odgovaraju na komentare, /insights vraća metrike, a webhook se proverava HMAC-SHA256 hešom sirovog tela zahteva. Svaka greška nosi kod i podkod koji određuju da li ponovni pokušaj može da pomogne.

easyCoexistence pokreće iste poslove kao MCP alate za Claude, ChatGPT ili vašeg agenta, a token ostaje na njegovoj strani: publish_instagram_post, reply_to_comment, get_social_insights i set_social_webhook_destination, preko Metinog zvaničnog API-ja.

v26.0

Najnovija verzija Graph API-ja, uvedena 29. jula 2026; v25.0 ostaje dostupna do 29. jula 2028.

Once a minute

Koliko često Meta predlaže proveru status_code-a video kontejnera, najduže 5 minuta.

50

Najviše komentara koje vrati jedan GET zahtev na /<IG_MEDIA_ID>/comments; odgovori se vraćaju samo proširenjem polja.

2207008

Privremena greška pri objavljivanju, za koju Meta kaže da se ponovi 1 do 2 puta u roku od 30 sekundi do 2 minuta.

sha256=

Prefiks u X-Hub-Signature-256, ispred HMAC-SHA256 heša payloada, računatog ključem app secretom.

Šta su primeri potrebni?

Runtime, token i četiri vrednosti. Primeri pozivaju Instagram API preko Instagram Login-a na graph.instagram.com; aplikacija sa Unified Login-om koristi iste putanje sa ID-jem naloga, na Graph hostu Facebook Login-a i sa tokenom Business Integration System User-a. Python zahteva paket requests, uz Flask za webhook, a Node.js verziju 18 ili noviju zbog ugrađenog fetch-a.

  • GRAPH: https://graph.instagram.com/v26.0, host i verzija API-ja.
  • IG_ID: ID profesionalnog naloga, user_id koji vraća GET /me.
  • TOKEN: dugotrajni Instagram User access token, čuva se na serveru.
  • APP_SECRET i VERIFY_TOKEN: za proveru webhook zahteva.

Kako se API poziva i greške obrađuju u Pythonu?

Preko jedne pomoćne funkcije koju dele svi Python primeri ispod. Ona šalje token kao access_token, podiže MetaError sa Metinim code, subcode i fbtrace_id, i ponavlja samo ono što Meta naziva privremenim: kodove 1 i 2, kodove ograničenja učestalosti 4, 17 i 80002, te podkodove 2207001, 2207003, 2207008 i 2207032. Kod 4 sa podkodom 2207051 znači sumnju na spam, pa se odmah prekida.

Python: the shared helper (requests)
import json
import time

import requests

GRAPH = "https://graph.instagram.com/v26.0"
IG_ID = "<IG_ID>"  # user_id from GET /me
TOKEN = "<TOKEN>"  # long-lived Instagram User access token, server side only

RETRY_CODES = {1, 2, 4, 17, 80002}
RETRY_SUBCODES = {2207001, 2207003, 2207008, 2207032}


class MetaError(Exception):
    def __init__(self, error: dict, status: int):
        super().__init__(error.get("message", f"HTTP {status}"))
        self.code = error.get("code")
        self.subcode = error.get("error_subcode")
        self.fbtrace_id = error.get("fbtrace_id")  # log it: Meta support asks for it

    @property
    def needs_new_token(self) -> bool:
        return self.code in (102, 190)

    @property
    def retryable(self) -> bool:
        if self.subcode == 2207051:  # code 4 with this subcode is suspected spam: stop
            return False
        return self.code in RETRY_CODES or self.subcode in RETRY_SUBCODES


def wait_seconds(resp) -> int:
    """estimated_time_to_regain_access from X-Business-Use-Case-Usage, at least 60 s."""
    try:
        usage = json.loads(resp.headers.get("X-Business-Use-Case-Usage", "{}"))
        minutes = max(e.get("estimated_time_to_regain_access", 0) for v in usage.values() for e in v)
    except (ValueError, AttributeError, TypeError):
        minutes = 0
    return max(60, int(minutes) * 60)


def graph(method: str, path: str, attempts: int = 3, **params) -> dict:
    if attempts < 1:
        raise ValueError("attempts must be at least 1")
    params["access_token"] = TOKEN
    for attempt in range(1, attempts + 1):
        resp = requests.request(method, f"{GRAPH}/{path}", params=params, timeout=30)
        try:
            data = resp.json()
        except ValueError:
            data = {}
        if resp.ok and "error" not in data:
            return data
        err = MetaError(data.get("error", {}), resp.status_code)
        if not err.retryable or attempt == attempts:
            raise err
        time.sleep(wait_seconds(resp))

Kako se API poziva i greške obrađuju u Node.js-u?

Istom pomoćnom funkcijom za Node.js 18 ili noviji, koja koristi fetch i nema zavisnosti. Zahtev koji je ograničen čeka onoliko minuta koliko Meta prijavi u polju estimated_time_to_regain_access zaglavlja X-Business-Use-Case-Usage, ili 60 sekundi ako ga nema, jer Meta broji i pozive upućene tokom ograničenja. needsNewToken označava kodove 190 i 102, koje nijedan ponovni pokušaj ne može da popravi.

Node.js: the shared helper (fetch, ES module)
const GRAPH = "https://graph.instagram.com/v26.0";
const IG_ID = process.env.IG_ID; // user_id from GET /me
const TOKEN = process.env.TOKEN; // long-lived Instagram User access token, server side only

const RETRY_CODES = new Set([1, 2, 4, 17, 80002]);
const RETRY_SUBCODES = new Set([2207001, 2207003, 2207008, 2207032]);

export class MetaError extends Error {
  constructor(error, status) {
    super(error.message ?? `HTTP ${status}`);
    this.code = error.code;
    this.subcode = error.error_subcode;
    this.fbtraceId = error.fbtrace_id; // log it: Meta support asks for it
  }
  get needsNewToken() {
    return this.code === 190 || this.code === 102;
  }
  get retryable() {
    if (this.subcode === 2207051) return false; // code 4 with this subcode is suspected spam: stop
    return RETRY_CODES.has(this.code) || RETRY_SUBCODES.has(this.subcode);
  }
}

export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

// estimated_time_to_regain_access from X-Business-Use-Case-Usage, at least 60 s
function waitMs(res) {
  try {
    const usage = JSON.parse(res.headers.get("x-business-use-case-usage") ?? "{}");
    const minutes = Math.max(0, ...Object.values(usage).flat().map((e) => e.estimated_time_to_regain_access ?? 0));
    return Math.max(60, minutes * 60) * 1000;
  } catch {
    return 60_000;
  }
}

export async function graph(method, path, params = {}, attempts = 3) {
  const url = new URL(`${GRAPH}/${path}`);
  for (const [key, value] of Object.entries({ ...params, access_token: TOKEN })) {
    url.searchParams.set(key, String(value));
  }
  for (let attempt = 1; attempt <= attempts; attempt++) {
    const res = await fetch(url, { method });
    const data = await res.json().catch(() => ({}));
    if (res.ok && !data.error) return data;
    const err = new MetaError(data.error ?? {}, res.status);
    if (!err.retryable || attempt === attempts) throw err;
    await sleep(waitMs(res));
  }
  throw new Error("attempts must be at least 1");
}

Kako se fotografija i Reel objavljuju u Pythonu?

Oba prate tok sa kontejnerom. Kontejner fotografije je spreman odmah, pa media_publish ide odmah posle njega. Video za Reel se prvo obrađuje: funkcija proverava status_code jednom u minut, najviše 5 minuta, kako Meta predlaže, objavljuje kada je FINISHED i prekida kod ERROR ili EXPIRED. Slike moraju biti JPEG, a medij mora biti na javnom URL-u.

Python: a photo and a Reel
# Uses graph(), IG_ID and time from the helper above
def publish_photo(image_url: str, caption: str) -> str:
    """A JPEG at a public URL: create the container, then publish it."""
    container = graph("POST", f"{IG_ID}/media", image_url=image_url, caption=caption)
    return graph("POST", f"{IG_ID}/media_publish", creation_id=container["id"])["id"]


def publish_reel(video_url: str, caption: str) -> str:
    """A Reel: publish once Meta has processed the video, checking once a minute."""
    cid = graph("POST", f"{IG_ID}/media", media_type="REELS", video_url=video_url, caption=caption)["id"]
    for _ in range(5):  # Meta: once a minute, for no more than 5 minutes
        time.sleep(60)
        status = graph("GET", cid, fields="status_code")["status_code"]
        if status == "FINISHED":
            return graph("POST", f"{IG_ID}/media_publish", creation_id=cid)["id"]
        if status in ("ERROR", "EXPIRED"):
            raise RuntimeError(f"Container {cid} ended as {status}")
    raise TimeoutError(f"Container {cid} is still processing: check it again later")

Kako se fotografija i Reel objavljuju u Node.js-u?

Iste dve funkcije, od kojih svaka vraća ID novog medija. Kontejner koji je i posle pet provera još IN_PROGRESS ostaje važeći 24 sata od nastanka, pa greška kaže da ga treba ponovo proveriti kasnije, što štedi pravljenje drugog kontejnera protiv dnevnog limita naloga od 400.

Node.js: a photo and a Reel
// Uses graph(), sleep() and IG_ID from the helper above
export async function publishPhoto(imageUrl, caption) {
  const { id } = await graph("POST", `${IG_ID}/media`, { image_url: imageUrl, caption });
  return (await graph("POST", `${IG_ID}/media_publish`, { creation_id: id })).id;
}

export async function publishReel(videoUrl, caption) {
  const { id } = await graph("POST", `${IG_ID}/media`, { media_type: "REELS", video_url: videoUrl, caption });
  for (let check = 0; check < 5; check++) {
    await sleep(60_000); // Meta: once a minute, for no more than 5 minutes
    const { status_code: status } = await graph("GET", id, { fields: "status_code" });
    if (status === "FINISHED") return (await graph("POST", `${IG_ID}/media_publish`, { creation_id: id })).id;
    if (status === "ERROR" || status === "EXPIRED") throw new Error(`Container ${id} ended as ${status}`);
  }
  throw new Error(`Container ${id} is still processing: check it again later`);
}

Kako se komentari čitaju i na njih odgovara u Pythonu?

GET /<IG_MEDIA_ID>/comments vraća komentare najvišeg nivoa, od najnovijeg ka starijem, do 50 po zahtevu, a POST /<IG_COMMENT_ID>/replies javno odgovara na jedan od njih. Funkcija za svaki odgovor traži tekst od vaše povratne funkcije i preskače komentare za koje ona ne vrati ništa. Sakrivenim komentarima nije moguće odgovoriti, a odgovor na odgovor završava kao odgovor na komentar najvišeg nivoa.

Python: read comments and reply
# Uses graph() from the helper above
def reply_to_comments(media_id: str, write_reply) -> int:
    """Reply in public to each comment write_reply returns text for."""
    page = graph("GET", f"{media_id}/comments", fields="id,text,username,timestamp")
    sent = 0
    for comment in page.get("data", []):
        text = write_reply(comment)
        if text:
            graph("POST", f"{comment['id']}/replies", message=text)
            sent += 1
    return sent


# Example: reply to questions about price
reply_to_comments("<IG_MEDIA_ID>", lambda c: "Prices are in our bio link." if "price" in c["text"].lower() else None)

Kako se komentari čitaju i na njih odgovara u Node.js-u?

Ista petlja u Node.js-u. Oba poziva traže dozvole instagram_business_basic i instagram_business_manage_comments, a polje username zahteva drugu. Da biste umesto toga odgovorili privatno, POST /<IG_ID>/messages sa recipient.comment_id šalje komentatoru jednu privatnu poruku, u roku od 7 dana od komentara, a naknadna poruka čeka dok on ne odgovori.

Node.js: read comments and reply
// Uses graph() from the helper above
// Reply in public to each comment writeReply returns text for
export async function replyToComments(mediaId, writeReply) {
  const { data = [] } = await graph("GET", `${mediaId}/comments`, { fields: "id,text,username,timestamp" });
  let sent = 0;
  for (const comment of data) {
    const text = writeReply(comment);
    if (text) {
      await graph("POST", `${comment.id}/replies`, { message: text });
      sent++;
    }
  }
  return sent;
}

// Example: reply to questions about price
await replyToComments("<IG_MEDIA_ID>", (c) => (/price/i.test(c.text) ? "Prices are in our bio link." : null));

Kako se metrike čitaju u Pythonu?

Metrike naloga zahtevaju period=day i metric_type=total_value, a svaka metrika tada vraća total_value.value; metrike objave vraćaju values[0].value. Primer traži reach, views i accounts_engaged za nalog, a za objavu ili Reel reach, views, likes, comments, saved i shares, što Metina referenca navodi za oba. Metrika bez podataka se izostavlja, a ne vraća se kao 0.

Python: account and post insights
# Uses graph() and IG_ID from the helper above
def account_insights() -> dict:
    """Reach, views and accounts engaged over the last 24 hours."""
    data = graph("GET", f"{IG_ID}/insights", metric="reach,views,accounts_engaged",
                 period="day", metric_type="total_value")["data"]
    return {m["name"]: m["total_value"]["value"] for m in data}


def post_insights(media_id: str) -> dict:
    """Totals for one post or Reel."""
    data = graph("GET", f"{media_id}/insights", metric="reach,views,likes,comments,saved,shares")["data"]
    return {m["name"]: m["values"][0]["value"] for m in data}

Kako se metrike čitaju u Node.js-u?

Ista dva zahteva u Node.js-u, od kojih svaki vraća objekat ključan imenom metrike. Nijedan ne šalje raščlanjivanje (breakdown): Meta upozorava da traženje raščlanjivanja koje metrika ne podržava zahtev obara sa nepoznatom greškom, i da podaci o metrikama mogu kasniti do 48 sati, pa recentne objave treba ponovo čitati kasnije.

Node.js: account and post insights
// Uses graph() and IG_ID from the helper above
// Reach, views and accounts engaged over the last 24 hours
export async function accountInsights() {
  const { data } = await graph("GET", `${IG_ID}/insights`, {
    metric: "reach,views,accounts_engaged",
    period: "day",
    metric_type: "total_value",
  });
  return Object.fromEntries(data.map((m) => [m.name, m.total_value?.value]));
}

// Totals for one post or Reel
export async function postInsights(mediaId) {
  const { data } = await graph("GET", `${mediaId}/insights`, { metric: "reach,views,likes,comments,saved,shares" });
  return Object.fromEntries(data.map((m) => [m.name, m.values?.[0]?.value]));
}

Kako se webhook proverava u Pythonu?

Pomoću Flask-a, u dve rute na istoj putanji. GET odgovara na Metin zahtev za verifikaciju: kada je hub.mode subscribe i hub.verify_token se poklapa, vraća hub.challenge kao običan tekst, a inače 403. POST izračunava sha256= plus HMAC-SHA256 sirovog tela sa app secretom, upoređuje ga sa X-Hub-Signature-256 u konstantnom vremenu i odgovara 200 pre nego što počne bilo kakav spor posao.

Python: webhook verification and signature check (Flask)
import hashlib
import hmac
import json
import os
from queue import Queue

from flask import Flask, abort, request

app = Flask(__name__)
VERIFY_TOKEN = os.environ["VERIFY_TOKEN"]
APP_SECRET = os.environ["APP_SECRET"].encode()
jobs: Queue = Queue()  # swap for your own job queue


@app.get("/webhooks/instagram")
def verify():
    """Meta's verification request: send hub.challenge back when the token matches."""
    args = request.args
    if args.get("hub.mode") == "subscribe" and args.get("hub.verify_token") == VERIFY_TOKEN:
        return args.get("hub.challenge", ""), 200, {"Content-Type": "text/plain"}
    abort(403)


@app.post("/webhooks/instagram")
def receive():
    """An event: check X-Hub-Signature-256 over the raw bytes, then answer at once."""
    raw = request.get_data()
    expected = b"sha256=" + hmac.new(APP_SECRET, raw, hashlib.sha256).hexdigest().encode()
    if not hmac.compare_digest(expected, request.headers.get("X-Hub-Signature-256", "").encode()):
        abort(401)
    for entry in json.loads(raw).get("entry", []):
        jobs.put(entry)  # slow work happens elsewhere; Meta wants a quick 200
    return "", 200

Kako se webhook proverava u Node.js-u?

Pomoću ugrađenog modula http, bez okvira. Telo se prikuplja kao sirovi bajtovi pre bilo kakve obrade, jer parsirano i ponovo serijalizovano telo više ne odgovara potpisu koji je Meta izračunala. Meta ponavlja neuspelo obaveštenje do 36 sati, pa rukovalac treba da preskače događaje koje je već obradio.

Node.js: webhook verification and signature check (node:http)
import crypto from "node:crypto";
import http from "node:http";

const { VERIFY_TOKEN, APP_SECRET } = process.env;
const PATH = "/webhooks/instagram";
const jobs = []; // swap for your own job queue

http
  .createServer((req, res) => {
    const url = new URL(req.url, "http://localhost");
    if (url.pathname !== PATH) return res.writeHead(404).end();

    if (req.method === "GET") {
      // Meta's verification request: send hub.challenge back when the token matches
      const ok =
        url.searchParams.get("hub.mode") === "subscribe" &&
        url.searchParams.get("hub.verify_token") === VERIFY_TOKEN;
      return res
        .writeHead(ok ? 200 : 403, { "Content-Type": "text/plain" })
        .end(ok ? url.searchParams.get("hub.challenge") ?? "" : "");
    }

    const chunks = [];
    req.on("data", (chunk) => chunks.push(chunk));
    req.on("end", () => {
      const raw = Buffer.concat(chunks); // the exact bytes Meta signed
      const expected = Buffer.from("sha256=" + crypto.createHmac("sha256", APP_SECRET).update(raw).digest("hex"));
      const given = Buffer.from(req.headers["x-hub-signature-256"] ?? "");
      if (given.length !== expected.length || !crypto.timingSafeEqual(given, expected)) {
        return res.writeHead(401).end();
      }
      res.writeHead(200).end(); // answer first, work after
      try {
        for (const entry of JSON.parse(raw.toString("utf8")).entry ?? []) jobs.push(entry);
      } catch {
        // not JSON: nothing to queue
      }
    });
  })
  .listen(3000);

Koje Metine greške kod treba ponovo da pokušava?

Samo privremene, jer sve ostale vraćaju isti odgovor dok se nešto ne promeni: fajl, URL, dozvola ili stanje naloga. Metine reference grešaka daju radnju za svaki kod koji pomoćne funkcije iznad razlikuju:

1, 2Temporary or downtime: wait, then retry
4, 17, 80002Throttling: wait for estimated_time_to_regain_access, then retry
4 with 2207051Suspected spam: stop, since a retry repeats the action
2207001, 2207003, 2207032Server error, download timeout or failed container: try again
2207008Container briefly missing: retry 1 to 2 times within 2 minutes
190, 102Token expired or invalid: refresh it while valid, or sign in again
10, 200 to 299Permission missing or removed: request it at sign-in
25 with 2207050Account restricted: the owner acts in the Instagram app
9 with 2207042Daily publishing limit: try again the next day
9004 with 2207052Media not fetched from the URL: fix the link

Kako se isti kod pokreće na kredencijalima easyCoexistence-a?

Ne možete ga pokrenuti na easyCoexistence tokenu: Instagram tokeni se nikad ne dele (Metini uslovi), pa get_social_credentials i GET /api/v1/channels/:id?credentials=1 u Partner API-ju vraćaju ID naloga i baznu API adresu bez tokena. Isti poslovi umesto toga rade kao MCP alati, preko Claude-a, ChatGPT-a ili drugog MCP klijenta, a pomoćne funkcije iznad rade bez izmena sa tokenom iz vaše sopstvene Meta aplikacije.

What get_social_credentials returns for an Instagram account
{
  "platform": "instagram",
  "graph_api_base": "https://graph.instagram.com/<VERSION>",
  "account_id_on_meta": "<IG_ID>",
  "access_token": null,
  "token_note": "Meta's terms do not allow handing this account's access token to other apps, so it is not shown. ..."
}

Kako se isti poslovi obavljaju preko MCP konektora?

Pitanjem asistentu ili direktnim pozivom alata. publish_instagram_post pravi i objavljuje kontejner, čeka dok se video obrađuje, ili zakazuje objavu sa scheduled_at do 90 dana unapred; reply_to_comment odgovara javno, ili privatno DM-om kada je private postavljeno na true; get_social_insights prosleđuje nazive metrika direktno Meti; a set_social_webhook_destination prosleđuje komentare, pominjanja i poruke vašem endpointu, potpisane sa X-EC-Signature.

MCP tool calls for the same jobs
[
  {
    "name": "publish_instagram_post",
    "arguments": {
      "account_id": "<from list_social_accounts>",
      "type": "REELS",
      "video_url": "https://cdn.example.com/launch.mp4",
      "caption": "Launch day.",
      "scheduled_at": "2026-11-06T09:00:00-03:00"
    }
  },
  {
    "name": "list_social_comments",
    "arguments": { "account_id": "<ACCOUNT_ID>", "post_id": "<IG_MEDIA_ID>" }
  },
  {
    "name": "reply_to_comment",
    "arguments": { "account_id": "<ACCOUNT_ID>", "comment_id": "<IG_COMMENT_ID>", "text": "Prices are in our bio link." }
  },
  {
    "name": "get_social_insights",
    "arguments": {
      "account_id": "<ACCOUNT_ID>",
      "metrics": ["reach", "views", "accounts_engaged"],
      "period": "day",
      "params": { "metric_type": "total_value" }
    }
  },
  {
    "name": "set_social_webhook_destination",
    "arguments": { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/instagram" }
  }
]

Česte greške

  • Heširanje parsiranog JSON-a. Meta potpisuje sirove bajtove, pa JSON parser okvira kvari proveru X-Hub-Signature-256; zadržite sirovo telo i parsirajte ga posle.
  • Ponovno pozivanje media_publish posle isteka vremena bez provere. Ako status_code kontejnera glasi PUBLISHED, objava je već uživo.
  • Čitanje koda 4 kao ograničenja učestalosti bez podkoda. Uz 2207051 to znači da Instagram sumnja na spam, a ponovni pokušaj ponavlja radnju koju je upravo ograničio.
  • Slanje app secreta ili tokena iz koda u pregledaču ili mobilnoj aplikaciji. Meta kaže da zahtevi sa app secretom pripadaju isključivo kodu na serveru.
Ovo radite uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mesečno, uz pad kako dodajete veze, uz besplatnih prvih 3 dana.

Često postavljana pitanja

Da li mi treba SDK za pozivanje Instagram API-ja?

Ne. Svaki poziv je HTTPS zahtev sa access tokenom, pa requests u Pythonu ili fetch u Node.js-u pokrivaju sve, kao što pokazuju primeri na ovoj stranici.

Zašto media_publish ne uspeva odmah posle kreiranja kontejnera za Reel?

Video se još obrađuje: greška 9007 sa podkodom 2207027. Proveravajte status_code kontejnera jednom u minut i objavite kada glasi FINISHED.

Koju verziju API-ja treba da koristi kod?

Onu koju Meta još služi: v26.0 je najnovija, a svaka verzija traje najmanje dve godine. Poziv uklonjene verzije se izvršava na sledećoj najstarijoj verziji koja je još dostupna.

Koliko košta easyCoexistence za pristup Instagram API-ju za jedan nalog?

Svaki Instagram nalog je jedna veza: od US$ 9 do US$ 0,75 po vezi mesečno, uz pad kako dodajete veze, uz besplatnih prvih 3 dana.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na