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.
Najnovija verzija Graph API-ja, predstavljena 29. srpnja 2026.; v25.0 ostaje dostupna do 29. srpnja 2028.
Koliko često Meta preporučuje provjeru status_code-a video kontejnera, najduže 5 minuta.
Najviše komentara koje jedan GET /<IG_MEDIA_ID>/comments zahtjev vraća; odgovori stižu samo proširenjem polja.
Privremena pogreška pri objavi, koju Meta preporučuje ponoviti 1 do 2 puta unutar 30 sekundi do 2 minute.
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_idkoji vraća GET /me.- TOKEN: dugotrajni pristupni token Instagram korisnika, čuvan na poslužitelju.
APP_SECRETiVERIFY_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.
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.
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.
# 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.
// 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.
# 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.
// 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.
# 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.
// 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.
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 "", 200Kako 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.
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:
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.
{
"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.
[
{
"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.
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