Instagram API dalam Python dan Node.js: contoh berfungsi
Instagram API hanya memerlukan HTTPS, jadi pustaka requests dalam Python dan fetch terbina dalam Node.js sudah mencukupi: POST /<IG_ID>/media kemudian media_publish untuk menerbitkan, /<IG_MEDIA_ID>/comments dan /<IG_COMMENT_ID>/replies untuk membaca dan membalas komen, /insights memulangkan metrik, dan webhook disahkan dengan HMAC-SHA256 bagi badan mentah. Setiap ralat membawa kod dan subkod yang menentukan sama ada percubaan semula boleh membantu.
easyCoexistence menjalankan tugas yang sama sebagai alat MCP untuk Claude, ChatGPT atau ejen anda sendiri, dengan token disimpan di sisinya: publish_instagram_post, reply_to_comment, get_social_insights dan set_social_webhook_destination, pada API rasmi Meta.
Versi Graph API terkini, diperkenalkan pada 29 Julai 2026; v25.0 kekal tersedia sehingga 29 Julai 2028.
Kekerapan yang Meta cadangkan untuk menyemak status_code bekas video, selama tidak lebih daripada 5 minit.
Bilangan komen paling banyak yang dikembalikan oleh satu permintaan GET /<IG_MEDIA_ID>/comments; balasan hanya dikembalikan melalui pengembangan medan.
Ralat penerbitan sementara, yang Meta nyatakan patut dicuba semula 1 hingga 2 kali dalam tempoh 30 saat hingga 2 minit.
Awalan dalam X-Hub-Signature-256, sebelum HMAC-SHA256 payload yang dikunci dengan rahsia aplikasi.
Apakah yang diperlukan oleh contoh-contoh ini?
Satu persekitaran larian, satu token dan empat nilai. Contoh memanggil Instagram API dengan Instagram Login pada graph.instagram.com; aplikasi Unified Login menggunakan laluan yang sama dengan ID akaun, pada hos Graph Facebook Login dengan token Business Integration System User-nya. Python memerlukan pakej requests, serta Flask untuk webhook, dan Node.js memerlukan versi 18 atau lebih baru untuk fetch terbina dalamnya.
- GRAPH: https://graph.instagram.com/v26.0, hos dan versi API.
IG_ID: ID akaun profesional, iaituuser_idyang dikembalikan oleh GET /me.- TOKEN: token akses Instagram User jangka panjang, disimpan di pelayan.
APP_SECRETdanVERIFY_TOKEN: untuk menyemak permintaan webhook.
Bagaimana anda memanggil API dan mengendalikan ralat dalam Python?
Melalui satu fungsi pembantu, yang dikongsi oleh contoh Python di bawah. Ia menghantar token sebagai access_token, menimbulkan MetaError dengan kod, subkod dan fbtrace_id Meta, dan hanya mencuba semula perkara yang Meta namakan sementara: kod 1 dan 2, kod had kadar 4, 17 dan 80002, serta subkod 2207001, 2207003, 2207008 dan 2207032. Kod 4 dengan subkod 2207051 bermaksud disyaki spam, jadi ia berhenti serta-merta.
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))Bagaimana anda memanggil API dan mengendalikan ralat dalam Node.js?
Dengan fungsi pembantu yang sama untuk Node.js 18 atau lebih baru, menggunakan fetch dan tanpa sebarang kebergantungan. Panggilan yang dihadkan kadarnya menunggu selama estimated_time_to_regain_access, iaitu minit yang Meta laporkan dalam header X-Business-Use-Case-Usage, atau 60 saat jika header itu tiada, kerana Meta mengira panggilan yang dibuat semasa had kadar. needsNewToken menandakan kod 190 dan 102, yang tiada percubaan semula dapat membetulkan.
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");
}Bagaimana anda menerbitkan foto dan Reel dalam Python?
Kedua-duanya mengikut aliran bekas. Bekas foto sedia serta-merta, jadi media_publish dipanggil terus selepasnya. Video Reel diproses dahulu: fungsi menyemak status_code sekali seminit selama sehingga 5 minit, seperti yang dicadangkan Meta, menerbitkan apabila FINISHED dan berhenti apabila ERROR atau EXPIRED. Imej mesti berformat JPEG, dan media mesti terletak pada URL awam.
# 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")Bagaimana anda menerbitkan foto dan Reel dalam Node.js?
Dua fungsi yang sama, masing-masing memulangkan ID media baharu. Bekas yang masih IN_PROGRESS selepas lima semakan kekal sah sehingga 24 jam selepas dicipta, jadi ralat itu meminta anda menyemaknya semula kemudian, yang menjimatkan daripada mencipta bekas kedua kerana akaun hanya dibenarkan 400 sehari.
// 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`);
}Bagaimana anda membaca komen dan membalas dalam Python?
GET /<IG_MEDIA_ID>/comments memulangkan komen peringkat atas, yang terbaharu dahulu, sehingga 50 setiap permintaan, dan POST /<IG_COMMENT_ID>/replies menghantar balasan awam kepada satu komen. Fungsi itu meminta panggil balik milik anda untuk teks setiap balasan dan melangkau komen yang tidak menghasilkan apa-apa. Komen tersembunyi tidak boleh dibalas, dan balasan kepada balasan akan masuk ke komen peringkat atas.
# 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)Bagaimana anda membaca komen dan membalas dalam Node.js?
Gelung yang sama dalam Node.js. Kedua-dua panggilan menggunakan instagram_business_basic dan instagram_business_manage_comments, dan medan username memerlukan yang kedua. Untuk membalas secara peribadi, POST /<IG_ID>/messages dengan recipient.comment_id menghantar satu DM kepada pemberi komen, dalam tempoh 7 hari daripada komen itu, dan susulan menunggu sehingga mereka membalas.
// 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));Bagaimana anda membaca metrik dalam Python?
Insight akaun menggunakan period=day dengan metric_type=total_value, dan setiap metrik kemudian melaporkan total_value.value; insight siaran melaporkan values[0].value. Contoh itu meminta reach, views dan accounts_engaged pada akaun, serta reach, views, likes, comments, saved dan shares pada siaran atau Reel, yang disenaraikan dalam rujukan Meta untuk kedua-duanya. Metrik tanpa data ditinggalkan, dan tidak dikembalikan sebagai 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}Bagaimana anda membaca metrik dalam Node.js?
Dua permintaan yang sama dalam Node.js, masing-masing memulangkan objek yang dikunci mengikut nama metrik. Tiada satu pun menghantar pecahan: Meta memberi amaran bahawa meminta pecahan yang tidak disokong oleh sesuatu metrik akan menggagalkan permintaan dengan ralat tidak diketahui, dan data insight boleh lewat sehingga 48 jam, jadi baca semula siaran terkini kemudian.
// 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]));
}Bagaimana anda mengesahkan webhook dalam Python?
Dengan Flask, dalam dua laluan pada satu path. GET menjawab permintaan pengesahan Meta: apabila hub.mode ialah subscribe dan hub.verify_token sepadan, ia memulangkan hub.challenge sebagai teks biasa, dan 403 jika tidak. POST mengira sha256= ditambah HMAC-SHA256 badan mentah dengan rahsia aplikasi, membandingkannya dengan X-Hub-Signature-256 dalam masa tetap, dan menjawab 200 sebelum sebarang kerja perlahan bermula.
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 "", 200Bagaimana anda mengesahkan webhook dalam Node.js?
Dengan modul http terbina dalam dan tanpa rangka kerja. Badan dikumpulkan sebagai bait mentah sebelum sebarang penghuraian, kerana badan yang dihuraikan dan diserialisasi semula tidak lagi sepadan dengan tandatangan yang Meta kira. Meta mencuba semula pemberitahuan yang gagal sehingga 36 jam, jadi pengendali juga patut melangkau peristiwa yang telah diproses.
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);Ralat Meta yang mana patut dicuba semula oleh kod?
Hanya yang sementara, kerana yang lain memberikan jawapan yang sama sehingga sesuatu berubah: fail, URL, kebenaran atau keadaan akaun. Rujukan ralat Meta memberikan tindakan bagi setiap kod yang dibezakan oleh fungsi pembantu di atas:
Bagaimana anda menjalankan kod yang sama dengan kelayakan easyCoexistence?
Anda tidak boleh menjalankannya dengan token easyCoexistence: token Instagram tidak pernah diserahkan (terma Meta), jadi get_social_credentials dan GET /api/v1/channels/:id?credentials=1 Partner API memulangkan ID akaun dan base API tanpa token. Tugas yang sama dijalankan sebagai alat MCP sebaliknya, melalui Claude, ChatGPT atau klien MCP lain, dan fungsi pembantu di atas berjalan tanpa perubahan pada token daripada aplikasi Meta anda sendiri.
{
"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. ..."
}Bagaimana anda menjalankan tugas yang sama melalui penyambung MCP?
Dengan meminta pembantu, atau dengan memanggil alat itu sendiri. publish_instagram_post mencipta dan menerbitkan bekas, menunggu semasa video diproses, atau menjadualkannya dengan scheduled_at sehingga 90 hari ke hadapan; reply_to_comment membalas secara awam, atau secara peribadi melalui DM apabila private ditetapkan kepada true; get_social_insights menghantar nama metrik terus kepada Meta; dan set_social_webhook_destination memajukan komen, sebutan dan DM ke endpoint anda, ditandatangani dengan 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" }
}
]Kesilapan biasa
- Mencincang JSON yang dihuraikan. Meta menandatangani bait mentah, jadi pengurai badan JSON rangka kerja merosakkan semakan X-Hub-Signature-256; simpan badan mentah dan huraikannya kemudian.
- Memanggil media_publish semula selepas tamat masa tanpa menyemak dahulu. Jika status_code bekas menunjukkan PUBLISHED, siaran sudah pun dalam talian.
- Membaca kod 4 sebagai had kadar tanpa subkod. Dengan 2207051 ia bermaksud Instagram disyaki spam, dan percubaan semula mengulangi tindakan yang baru sahaja disekat.
- Menghantar rahsia aplikasi atau token dari kod pelayar atau aplikasi mudah alih. Meta menyatakan permintaan yang membawa rahsia aplikasi hanya patut berada dalam kod bahagian pelayan.
US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Adakah saya perlukan SDK untuk memanggil Instagram API?
Tidak. Setiap panggilan ialah permintaan HTTPS dengan token akses, jadi requests dalam Python atau fetch dalam Node.js sudah mencukupi, seperti yang ditunjukkan oleh contoh di halaman ini.
Mengapa media_publish gagal sejurus selepas bekas Reel dicipta?
Video masih diproses: ralat 9007 dengan subkod 2207027. Semak status_code bekas sekali seminit dan terbitkan apabila ia menunjukkan FINISHED.
Versi API yang mana patut digunakan oleh kod?
Versi yang masih disediakan oleh Meta: v26.0 ialah yang terkini, dan setiap versi kekal sekurang-kurangnya dua tahun. Panggilan kepada versi yang telah dialih keluar akan dijalankan pada versi lama seterusnya yang masih tersedia.
Berapa kos easyCoexistence untuk akses API bagi satu akaun Instagram?
Setiap akaun Instagram ialah satu sambungan: US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada