Instagram API di Python dan Node.js: contoh kode yang bisa dijalankan
Instagram API hanya membutuhkan HTTPS, jadi requests di Python dan fetch bawaan Node.js sudah cukup: POST /<IG_ID>/media lalu media_publish untuk menerbitkan, /<IG_MEDIA_ID>/comments dan /<IG_COMMENT_ID>/replies untuk membaca dan membalas komentar, /insights untuk metrik, serta webhook diperiksa dengan HMAC-SHA256 dari body mentah. Setiap kesalahan membawa kode dan subkode yang menentukan apakah percobaan ulang bisa membantu.
easyCoexistence menjalankan tugas yang sama sebagai tool MCP untuk Claude, ChatGPT, atau agen Anda sendiri, dengan token tetap berada di sisinya: publish_instagram_post, reply_to_comment, get_social_insights, dan set_social_webhook_destination, di atas Instagram API resmi Meta.
Versi Graph API terbaru, diperkenalkan 29 Juli 2026; v25.0 tetap tersedia hingga 29 Juli 2028.
Seberapa sering Meta menyarankan memeriksa status_code sebuah container video, selama tidak lebih dari 5 menit.
Jumlah maksimum komentar yang dikembalikan satu permintaan GET /<IG_MEDIA_ID>/comments; balasan hanya datang melalui field expansion.
Kesalahan publikasi sementara, yang menurut Meta harus dicoba ulang 1 hingga 2 kali dalam 30 detik hingga 2 menit.
Awalan di X-Hub-Signature-256, sebelum HMAC-SHA256 dari payload yang dikunci dengan app secret.
Apa yang dibutuhkan contoh-contoh ini?
Sebuah runtime, sebuah token, dan empat nilai. Contoh memanggil Instagram API dengan Instagram Login di graph.instagram.com; aplikasi Unified Login memakai jalur yang sama dengan ID akun, di host Graph milik Facebook Login dengan token Business Integration System User-nya. Python membutuhkan paket requests, ditambah Flask untuk webhook, dan Node.js membutuhkan versi 18 atau yang lebih baru untuk fetch bawaannya.
- GRAPH: https://graph.instagram.com/v26.0, host dan versi API.
IG_ID: ID akun profesional, yaituuser_idyang dikembalikan GET /me.- TOKEN: token akses Instagram User berumur panjang, disimpan di server.
APP_SECRETdanVERIFY_TOKEN: untuk memeriksa permintaan webhook.
Bagaimana cara memanggil API dan menangani kesalahan di Python?
Melalui satu fungsi pembantu, yang dipakai bersama oleh contoh Python di bawah. Fungsi ini mengirim token sebagai access_token, memunculkan MetaError dengan kode, subkode, dan fbtrace_id dari Meta, serta hanya mencoba ulang kesalahan yang oleh Meta disebut sementara: kode 1 dan 2, kode pembatasan laju 4, 17, dan 80002, serta subkode 2207001, 2207003, 2207008, dan 2207032. Kode 4 dengan subkode 2207051 berarti dugaan spam, sehingga langsung dihentikan.
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 cara memanggil API dan menangani kesalahan di Node.js?
Dengan fungsi pembantu yang sama untuk Node.js 18 atau yang lebih baru, memakai fetch tanpa dependensi. Panggilan yang dibatasi akan menunggu estimated_time_to_regain_access, yaitu menit yang dilaporkan Meta di header X-Business-Use-Case-Usage, atau 60 detik jika header itu tidak ada, karena Meta menghitung panggilan yang dibuat saat sedang dibatasi. needsNewToken menandai kode 190 dan 102, yang tidak bisa diperbaiki dengan percobaan ulang apa pun.
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 cara mempublikasikan foto dan Reel di Python?
Keduanya mengikuti alur container. Container foto siap seketika, sehingga media_publish langsung dijalankan sesudahnya. Video Reel diproses lebih dulu: fungsi memeriksa status_code sekali setiap menit selama hingga 5 menit, sesuai saran Meta, lalu menerbitkan saat status FINISHED dan berhenti saat statusnya kesalahan (ERROR) atau EXPIRED. Gambar harus berformat JPEG, dan media harus berada di URL publik.
# 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 cara mempublikasikan foto dan Reel di Node.js?
Dua fungsi yang sama, masing-masing mengembalikan ID media yang baru. Container yang masih IN_PROGRESS setelah lima kali pemeriksaan tetap berlaku hingga 24 jam setelah dibuat, sehingga kesalahan menyarankan untuk memeriksanya lagi nanti. Dengan begitu tidak perlu membuat container kedua yang ikut dihitung dalam kuota 400 per hari milik akun.
// 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 cara membaca komentar dan membalas di Python?
GET /<IG_MEDIA_ID>/comments mengembalikan komentar tingkat teratas, dari yang terbaru, hingga 50 per permintaan, dan POST /<IG_COMMENT_ID>/replies mengirim balasan publik untuk satu komentar. Fungsi meminta callback milik Anda untuk teks setiap balasan, dan melewati komentar yang tidak dikembalikan apa pun. Komentar tersembunyi tidak bisa dibalas, dan balasan atas balasan akan masuk ke komentar tingkat teratas.
# 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 cara membaca komentar dan membalas di Node.js?
Loop yang sama dalam Node.js. Kedua panggilan memakai instagram_business_basic dan instagram_business_manage_comments, dan field username membutuhkan izin kedua. Untuk membalas secara pribadi, POST /<IG_ID>/messages dengan recipient.comment_id mengirim satu DM kepada pemberi komentar, dalam 7 hari sejak komentar dibuat, dan tindak lanjut menunggu sampai 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 cara membaca insight di Python?
Insight akun memakai period=day dengan metric_type=total_value, lalu setiap metrik melaporkan total_value.value; insight sebuah postingan melaporkan values[0].value. Contoh meminta reach, views, dan accounts_engaged untuk akun, serta reach, views, likes, comments, saved, dan shares untuk postingan atau Reel, yang tercantum di referensi Meta untuk keduanya. Metrik tanpa data dihilangkan, bukan 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 cara membaca insight di Node.js?
Dua permintaan yang sama dalam Node.js, masing-masing mengembalikan objek yang dikunci dengan nama metrik. Tidak ada yang mengirim breakdown: Meta memperingatkan bahwa meminta breakdown yang tidak didukung sebuah metrik akan membuat permintaan gagal dengan kesalahan tidak dikenal, dan data insight bisa tertinggal hingga 48 jam, jadi baca ulang postingan terbaru nanti.
// 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 cara memverifikasi webhook di Python?
Dengan Flask, dalam dua route pada satu path. GET menjawab permintaan verifikasi dari Meta: ketika hub.mode bernilai subscribe dan hub.verify_token cocok, ia mengembalikan hub.challenge sebagai teks biasa, dan 403 jika tidak. POST menghitung sha256= ditambah HMAC-SHA256 dari body mentah dengan app secret, membandingkannya dengan X-Hub-Signature-256 dalam waktu konstan, dan menjawab 200 sebelum pekerjaan berat dimulai.
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 cara memverifikasi webhook di Node.js?
Dengan modul http bawaan tanpa framework. Body dikumpulkan sebagai byte mentah sebelum apa pun mem-parse-nya, karena body yang sudah di-parse lalu diserialisasi ulang tidak lagi cocok dengan tanda tangan yang dihitung Meta. Meta mencoba ulang notifikasi yang gagal hingga 36 jam, jadi handler sebaiknya juga melewati event yang sudah pernah 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);Kesalahan Meta mana yang sebaiknya dicoba ulang oleh kode?
Hanya yang sementara, karena yang lain akan memberikan jawaban yang sama sampai ada yang berubah: file, URL, izin, atau status akun. Referensi kesalahan Meta memberikan tindakan untuk setiap kode yang dibedakan oleh fungsi pembantu di atas:
Bagaimana menjalankan kode yang sama dengan kredensial easyCoexistence?
Anda tidak dapat menjalankannya dengan token easyCoexistence: token Instagram tidak pernah diberikan (ketentuan Meta), sehingga get_social_credentials dan GET /api/v1/channels/:id?credentials=1 pada Partner API mengembalikan ID dan base API akun tanpa token. Tugas yang sama berjalan sebagai tool MCP, melalui Claude, ChatGPT, atau klien MCP lain, dan fungsi pembantu di atas berjalan tanpa perubahan dengan token dari 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 menjalankan tugas yang sama melalui konektor MCP?
Dengan meminta asisten, atau dengan memanggil tool-nya sendiri. publish_instagram_post membuat dan menerbitkan container, menunggu selama video diproses, atau menjadwalkannya dengan scheduled_at hingga 90 hari ke depan; reply_to_comment membalas secara publik, atau secara pribadi lewat DM dengan private bernilai true; get_social_insights meneruskan nama metrik langsung ke Meta; dan set_social_webhook_destination meneruskan komentar, mention, 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" }
}
]Kesalahan umum
- Melakukan hash pada JSON yang sudah di-parse. Meta menandatangani byte mentah, sehingga parser body JSON dari framework merusak pemeriksaan X-Hub-Signature-256; simpan body mentah dan parse setelahnya.
- Memanggil media_publish lagi setelah timeout tanpa memeriksa dulu. Jika status_code container terbaca PUBLISHED, postingan sudah tayang.
- Membaca kode 4 sebagai pembatasan laju tanpa subkodenya. Dengan 2207051 artinya Instagram menduga spam, dan percobaan ulang mengulangi tindakan yang baru saja dibatasi.
- Mengirim app secret atau token dari kode browser atau mobile. Meta menyatakan permintaan yang membawa app secret hanya boleh ada di kode sisi server.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah saya perlu SDK untuk memanggil Instagram API?
Tidak. Setiap panggilan adalah permintaan HTTPS dengan token akses, sehingga requests di Python atau fetch di Node.js sudah cukup, seperti yang ditunjukkan contoh di halaman ini.
Mengapa media_publish gagal tepat setelah container Reel dibuat?
Video masih diproses: kesalahan 9007 dengan subkode 2207027. Periksa status_code container sekali setiap menit dan terbitkan saat tertulis FINISHED.
Versi API mana yang sebaiknya dipakai kode?
Yang masih dilayani Meta: v26.0 adalah yang terbaru, dan setiap versi berlaku minimal dua tahun. Panggilan ke versi yang sudah dihapus akan dijalankan pada versi terlama berikutnya yang masih tersedia.
Berapa biaya easyCoexistence untuk akses API ke akun Instagram?
Setiap akun Instagram adalah satu koneksi: US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada