Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Instagram API u Pythonu i Node.js-u: radni primjeri

Instagram API ne traži ništa osim HTTPS-a, pa biblioteka requests u Pythonu i ugrađeni fetch u Node.js-u dovoljni su za sve: POST /<IG_ID>/media, zatim media_publish objavljuje, /<IG_MEDIA_ID>/comments i /<IG_COMMENT_ID>/replies čitaju komentare i odgovaraju na njih, /insights vraća metrike, a webhook se provjerava HMAC-SHA256 hashom neobrađenog tijela. Svaka pogreška nosi kôd i potkôd koji određuju hoće li ponovni pokušaj pomoći.

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 službenog API-ja.

v26.0

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

Once a minute

Koliko često Meta preporučuje provjeru status_code-a video kontejnera, najduže 5 minuta.

50

Najviše komentara koje jedan GET /<IG_MEDIA_ID>/comments zahtjev vraća; odgovori stižu samo proširenjem polja.

2207008

Privremena pogreška pri objavi, koju Meta preporučuje ponoviti 1 do 2 puta unutar 30 sekundi do 2 minute.

sha256=

Prefiks u X-Hub-Signature-256, ispred HMAC-SHA256 vrijednosti payloada izračunate pomoću tajnog ključa aplikacije.

Što primjeri trebaju?

Okruženje za izvođenje, token i četiri vrijednosti. Primjeri pozivaju Instagram API putem Instagram Logina na graph.instagram.com. Aplikacija s postavkom Unified Login koristi iste putanje s ID-om računa, na Graph hostu Facebook Logina i s tokenom korisnika Business Integration System User. Python treba paket requests i Flask za webhook, a Node.js verziju 18 ili noviju zbog ugrađenog fetcha.

  • GRAPH: https://graph.instagram.com/v26.0, host i verzija API-ja.
  • IG_ID: ID profesionalnog računa, user_id koji vraća GET /me.
  • TOKEN: dugotrajni pristupni token Instagram korisnika, čuvan na poslužitelju.
  • APP_SECRET i VERIFY_TOKEN: za provjeru zahtjeva webhooka.

Kako pozivati API i obrađivati pogreške u Pythonu?

Kroz jednu pomoćnu funkciju koju dijele svi primjeri za Python. Šalje token kao access_token, podiže MetaError s Metinim kôdom, potkôdom i fbtrace_id-om te ponavlja samo ono što Meta naziva privremenim: kodove 1 i 2, kodove ograničenja brzine 4, 17 i 80002 te potkôdove 2207001, 2207003, 2207008 i 2207032. Kôd 4 s potkôdom 2207051 znači sumnju na spam, pa se odmah zaustavlja.

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 pozivati API i obrađivati pogreške u Node.js-u?

Istom pomoćnom funkcijom za Node.js 18 ili noviju, koja koristi fetch i nema ovisnosti. Ograničeni poziv čeka estimated_time_to_regain_access, minute koje Meta navodi u zaglavlju X-Business-Use-Case-Usage, ili 60 sekundi bez njega, jer Meta broji pozive upućene dok je ograničenje aktivno. needsNewToken označava kodove 190 i 102, koje nijedan ponovni pokušaj ne može popraviti.

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 objaviti fotografiju i Reel u Pythonu?

Oba slijede tijek kontejnera. Kontejner fotografije je odmah spreman, pa media_publish ide odmah nakon njega. Video Reela prvo se obrađuje: funkcija provjerava status_code jednom u minuti do najviše 5 minuta, kako Meta preporučuje, objavljuje kad je FINISHED i zaustavlja se na 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 objaviti fotografiju i Reel u Node.js-u?

Iste dvije funkcije, a svaka vraća ID novog medija. Kontejner koji je i nakon pet provjera još IN_PROGRESS ostaje valjan do 24 sata od nastanka, pa pogreška kaže da ga provjerite kasnije, što štedi stvaranje drugog kontejnera protiv dnevne granice računa 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 čitati komentare i odgovarati u Pythonu?

GET /<IG_MEDIA_ID>/comments vraća komentare najviše razine, od najnovijeg, do 50 po zahtjevu, 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. Skriveni komentari ne mogu dobiti odgovor, a odgovor na odgovor završi na komentaru najviše razine.

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 čitati komentare i odgovarati u Node.js-u?

Ista petlja u Node.js-u. Oba poziva koriste instagram_business_basic i instagram_business_manage_comments, a polje username treba drugi. Za privatni odgovor umjesto toga, POST /<IG_ID>/messages s recipient.comment_id šalje komentatoru jednu izravnu poruku, unutar 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 čitati uvide u Pythonu?

Uvidi računa traže period=day s metric_type=total_value, a svaka metrika zatim prijavljuje total_value.value; uvidi objave prijavljuju values[0].value. Primjer traži doseg, prikaze i accounts_engaged za račun te doseg, prikaze, sviđanja, komentare, spremanja i dijeljenja za objavu ili Reel, što Metin referentni popis navodi za oba. Metrika bez podataka izostavlja se umjesto da se vrati 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 čitati uvide u Node.js-u?

Isti dva zahtjeva u Node.js-u, a svaki vraća objekt s ključem po nazivu metrike. Nijedan ne šalje raščlambu: Meta upozorava da traženje raščlambe koju metrika ne podržava ruši zahtjev s nepoznatom pogreškom, a podaci uvida mogu kasniti do 48 sati, pa nedavne objave treba ponovno č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 provjeriti webhook u Pythonu?

Uz Flask, u dvije rute na istoj putanji. GET odgovara na Metin zahtjev za provjeru: kad je hub.mode subscribe i hub.verify_token se podudara, vraća hub.challenge kao običan tekst, a inače 403. POST izračunava sha256= plus HMAC-SHA256 neobrađenog tijela s tajnim ključem aplikacije, uspoređuje ga s X-Hub-Signature-256 u stalnom vremenu i odgovara 200 prije nego što krene spora obrada.

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 provjeriti webhook u Node.js-u?

Ugrađenim modulom http, bez okvira. Tijelo se prikuplja kao sirovi bajtovi prije bilo kakve raščlambe, jer raščlanjeno i ponovno serijalizirano tijelo više ne odgovara potpisu koji je Meta izračunala. Meta ponavlja neuspjelu obavijest do 36 sati, pa rukovatelj treba preskočiti 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 pogreške kod treba ponavljati?

Samo privremene, jer ostale vraćaju isti odgovor dok se nešto ne promijeni: datoteku, URL, dopuštenje ili stanje računa. Metini referentni popisi pogrešaka navode radnju za svaki kôd koji gore navedene pomoćne funkcije 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 isti kod pokrenuti s vjerodajnicama easyCoexistence?

Ne možete ga pokretati s tokenom usluge easyCoexistence: Instagram tokeni se nikad ne predaju (Metini uvjeti), pa get_social_credentials i GET /api/v1/channels/:id?credentials=1 u Partner API-ju vraćaju ID računa i osnovnu adresu API-ja bez tokena. Isti poslovi umjesto toga rade kao MCP alati, kroz Claude, ChatGPT ili drugi MCP klijent, a gornje pomoćne funkcije rade nepromijenjene s tokenom iz vaše vlastite 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 obavljati iste poslove preko MCP konektora?

Pitanjem asistenta ili pozivanjem alata izravno. publish_instagram_post stvara i objavljuje kontejner, čekajući dok se video obrađuje, ili zakazuje objavu s scheduled_at do 90 dana unaprijed; reply_to_comment odgovara javno ili privatno izravnom porukom uz private postavljen na true; get_social_insights prosljeđuje nazive metrika Meti izravno; a set_social_webhook_destination preusmjerava komentare, spominjanja i izravne poruke na vaš endpoint, potpisane s 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" }
  }
]

Uobičajene pogreške

  • Hashiranje parsiranog JSON-a. Meta potpisuje neobrađene bajtove, pa JSON parser okvira kvari provjeru X-Hub-Signature-256; zadržite neobrađeno tijelo i tek ga onda parsirajte.
  • Ponovno pozivanje media_publish nakon isteka vremena bez provjere. Ako status_code kontejnera glasi PUBLISHED, objava je već aktivna.
  • Čitanje koda 4 kao ograničenja brzine bez potkoda. S 2207051 znači da Instagram sumnja na spam, a ponovni pokušaj ponavlja radnju koju je upravo ograničio.
  • Slanje tajnog ključa aplikacije ili tokena iz koda u pregledniku ili mobilnoj aplikaciji. Meta kaže da zahtjevi s tajnim ključem aplikacije pripadaju isključivo kodu na poslužitelju.
Radite ovo uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mjesečno, uz smanjenje kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Treba li mi SDK za pozivanje Instagram API-ja?

Ne. Svaki poziv je HTTPS zahtjev s pristupnim tokenom, pa su requests u Pythonu ili fetch u Node.js-u dovoljni, kao što pokazuju primjeri na ovoj stranici.

Zašto media_publish ne uspijeva odmah nakon stvaranja kontejnera za Reel?

Video se još obrađuje: pogreška 9007 s potkôdom 2207027. Provjerite status_code kontejnera jednom u minuti i objavite kad glasi FINISHED.

Koju verziju API-ja treba koristiti kod?

Onu koju Meta još poslužuje: v26.0 je najnovija, a svaka verzija traje najmanje dvije godine. Poziv na uklonjenu verziju izvršava se na sljedećoj najstarijoj verziji koja je još dostupna.

Koliko košta easyCoexistence za pristup Instagram API-ju za jedan račun?

Svaki Instagram račun je jedna veza: od US$ 9 do US$ 0,75 po vezi mjesečno, uz smanjenje kako dodajete veze, uz prva 3 dana besplatno.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na