Instagram Graph API: dasturchi uchun to'liq qo'llanma
Bugungi Instagram API — Meta'ning Instagram Platform'i: bitta Graph API va ikki xil ulanish usuli. Instagram Login faqat professional akkaunt bilan ishlaydi va graph.instagram.com ga murojaat qiladi; Facebook Login esa bog'langan Facebook sahifasini talab qiladi va graph.facebook.com orqali ishlaydi. Shaxsiy akkauntlar qo'llab-quvvatlanmaydi, eski Basic Display API esa 2024-yil 4-dekabrda o'chirilgan.
Yangilangan:
2026-yilda Instagram API nima?
Instagram API — Meta'ning Instagram Platform'i: professional akkauntlar uchun Graph API endpointlari to'plami. Ikki variantdan birini tanlaysiz: Instagram API with Instagram Login (Facebook sahifasi kerak emas, graph.instagram.com) yoki Instagram API with Facebook Login (akkaunt sahifaga bog'langan, graph.facebook.com). Ikkalasida ham post joylash, izohlar, statistika va eslatmalar bor; xabarlar va qidiruv imkoniyatlari farq qiladi.
Instagram Login varianti 2024-yil 23-iyulda ishga tushgan. Undan oldin har qanday integratsiya Facebook sahifasi orqali qurilardi — shuning uchun eski qo'llanmalar hamon page token'dan boshlanadi.
Shaxsiy akkaunt rasmlarini saytda ko'rsatish uchun ishlatilgan Instagram Basic Display API 2024-yil 4-dekabrda eskirgan deb e'lon qilindi va unga yuborilgan har bir so'rov endi xato qaytaradi. Ochiq postlarni saytga joylash uchun oEmbed API bor — 2026-yil 15-maydan boshlab uni access token'siz chaqirish mumkin.
2025-yil 27-yanvarda Instagram Login'ning eski scope nomlari (business_basic, business_content_publish, business_manage_comments, business_manage_messages) o'chirildi, o'rniga instagram_business_* nomlari keldi. Login oynasi scope'ni birdan rad eta boshlasa, avval shuni tekshiring.
Instagram Login yoki Facebook Login: qaysi birini tanlash kerak?
Ikkala variant ham bir xil Instagram ma'lumotlari bilan ishlaydi, lekin login oynasi, host, token turi va ayrim imkoniyatlar bilan farqlanadi.
| Instagram Login | Facebook Login | |
|---|---|---|
| Kim orqali kiriladi | Instagram login va paroli | Facebook login va paroli |
| Facebook sahifasi | Kerak emas | Kerak, Instagram akkauntiga bog'langan bo'lishi shart |
| API host | graph.instagram.com | graph.facebook.com |
| Token | Instagram User access token | Facebook User yoki Page access token |
| Scope nomlari | instagram_business_* | instagram_* va pages_* |
| Post joylash, izohlar, statistika, eslatmalar | Bor | Bor |
| Direct xabarlar | Bor | Messenger Platform orqali |
| Heshteg qidiruvi, business discovery | Yo'q | Bor |
| Mahsulot teglari, partnership ads | Yo'q | Bor |
Izohlar va cheklovlar
Oddiy qoida: heshteg qidiruvi, boshqa akkauntlar ma'lumoti yoki reklama imkoniyatlari kerak bo'lmasa, Instagram Login soddaroq — foydalanuvchilaringizga Facebook sahifasi kerak bo'lmaydi.
Qaysi Instagram akkauntlar API bilan ishlaydi?
Faqat professional akkauntlar — Business yoki Creator. Shaxsiy akkauntga ikkala variant orqali ham kirib bo'lmaydi. Foydalanuvchilardan keladigan birinchi savol odatda Instagram ilovasi sozlamalarida akkaunt turini almashtirish bilan hal bo'ladi.
Facebook Login variantida professional akkaunt Facebook sahifasiga bog'langan bo'lishi, login qilayotgan odam esa shu sahifada vazifaga (task) ega bo'lishi kerak. Ayrim imkoniyatlarda qo'shimcha shart bor: masalan, Meta'ning Facebook Login hujjatida story joylash faqat business akkauntlar uchun ekani yozilgan.
API har doim ilovangizga ruxsat bergan akkaunt nomidan ishlaydi. Bu ixtiyoriy profillarni o'qish vositasi emas: boshqa akkauntlar haqida ma'lumot faqat heshteg qidiruvi va business discovery orqali olinadi, ikkalasi ham faqat Facebook Login'da va App Review'dan keyin.
Instagram API bilan nima qilish mumkin?
Kontent joylash
Rasm, Reels, 10 tagacha elementli karusel va story — konteyner → e'lon oqimi bilan. Limit: sutkasiga (surilib boruvchi 24 soat) API orqali 100 ta post.
Izohlarni boshqarish
Izohlarni o'qish, javob berish, yashirish, o'chirish va post uchun izohlarni o'chirib qo'yish. Private reply — izoh egasiga 7 kun ichida bitta shaxsiy xabar.
Direct xabarlar
Xabarlar webhook orqali keladi, javob 24 soatlik oyna ichida yuboriladi; suhbatlar va xabarlar tarixini API orqali o'qish mumkin.
Statistika (insights)
Akkaunt va post ko'rsatkichlari. 100 tadan kam obunachisi bor akkauntlarda ayrim metrikalar yo'q; akkaunt metrikalari 90 kungacha saqlanadi.
Eslatmalar (mentions)
Akkaunt @eslatilgan medialarni topish va mentions webhook'i orqali xabar olish.
Heshteg qidiruvi va business discovery
Faqat Facebook Login. Bitta akkaunt uchun surilib boruvchi 7 kunda 30 tagacha noyob heshteg; Instagram Public Content Access funksiyasi kerak.
Instagram API ruxsatlari: qaysi imkoniyatga qaysi scope
Faqat kerakli ruxsatlarni so'rang — har bir ortiqcha ruxsat App Review'da yana bitta tekshiruv bandi demakdir.
| Imkoniyat | Instagram Login | Facebook Login |
|---|---|---|
| Profil va media | instagram_business_basic | instagram_basic, pages_show_list |
| Post joylash | instagram_business_basic, instagram_business_content_publish | instagram_basic, instagram_content_publish, pages_read_engagement |
| Izohlar va private reply | instagram_business_basic, instagram_business_manage_comments | instagram_basic, instagram_manage_comments, pages_read_engagement |
| Statistika | instagram_business_basic, instagram_business_manage_insights | instagram_basic, instagram_manage_insights, pages_read_engagement |
| Direct xabarlar | instagram_business_basic, instagram_business_manage_messages | instagram_basic, instagram_manage_messages, pages_manage_metadata |
| Heshteg qidiruvi | Mavjud emas | instagram_basic + Instagram Public Content Access |
Izohlar va cheklovlar
Facebook Login'da odamning sahifadagi roli Business Manager orqali berilgan bo'lsa, Meta post joylash, izohlar va statistika uchun qo'shimcha ads_management va ads_read ruxsatlarini ham ko'rsatadi.
Standard Access, Advanced Access va App Review
Har bir Business turidagi ilova barcha ruxsatlariga Standard Access bilan boshlaydi. Bu ishlab chiqish uchun va faqat o'zingizga tegishli yoki o'zingiz boshqaradigan akkauntlar bilan ishlaydigan ilova uchun yetarli — foydalanuvchilar ilovada rolga ega bo'lishi kerak.
Ilova sizga tegishli bo'lmagan professional akkauntlarga xizmat qila boshlashi bilan (ya'ni har qanday SaaS mahsulot) Advanced Access talab qilinadi. U har bir ruxsat uchun alohida App Review orqali beriladi, Business Verification esa majburiy.
Funksiyalar (features) ham shunday ko'rib chiqiladi. Human Agent (odam tomonidan Direct'ga 7 kungacha javob berish) va Instagram Public Content Access (heshteg qidiruvi) — ruxsat emas, funksiya, ikkalasi ham tasdiqlashni talab qiladi.
Ikki amaliy tuzoq: webhook xabarlarini olish uchun ilova Live rejimida bo'lishi shart, comments va live_comments webhook'lari esa faqat Advanced Access bilan yetkaziladi.
Instagram API limitlari: qisqacha jadval
Instagram'da bir nechta mustaqil limit bor — biriga urilish boshqalariga ta'sir qilmaydi.
| Limit | Qiymat | Qo'llanilishi |
|---|---|---|
| Business Use Case (BUC) | 24 soatda 4800 × impressions | Ko'pchilik Instagram Platform endpointlari, akkaunt bo'yicha |
| Platform Rate Limiting | Alohida formula | Heshteg qidiruvi va business discovery |
| Post joylash | Surilib boruvchi 24 soatda 100 ta API post | Akkaunt bo'yicha; karusel bitta post hisoblanadi |
| Media konteynerlar | Surilib boruvchi 24 soatda 400 ta | Akkaunt bo'yicha |
| Heshteg qidiruvi | Surilib boruvchi 7 kunda 30 ta noyob heshteg | Akkaunt bo'yicha |
| Conversations API | Soniyasiga 2 ta chaqiruv | Akkaunt bo'yicha |
| Send API | Matn, havola, reaksiya, stiker: soniyasiga 100 ta; audio va video: soniyasiga 10 ta | Akkaunt bo'yicha |
| Private replies | Post va Reels: soatiga 750 ta; Live: soniyasiga 100 ta | Akkaunt bo'yicha |
Izohlar va cheklovlar
Impressions — oxirgi 24 soatda akkaunt kontenti kimningdir ekraniga necha marta chiqqani. BUC sarfi X-Business-Use-Case-Usage javob sarlavhasida keladi; Instagram BUC limiti oshganda 80002 xato kodi qaytadi.
Instagram API'ni qanday ulash mumkin: qadamma-qadam
Professional akkaunt
Instagram ilovasi sozlamalarida akkauntni Business yoki Creator turiga o'tkazing. Facebook Login uchun uni Facebook sahifasiga ham bog'lang.
Meta ilovasi
developers.facebook.com da Business turidagi ilova yarating va Instagram mahsulotini qo'shing. Instagram Login uchun "API setup with Instagram business login" bo'limini tanlang.
Redirect URI va scope'lar
OAuth redirect URI'ni ro'yxatdan o'tkazing va faqat kerakli ruxsatlarni so'rang. Login URL'dagi redirect_uri keyingi almashinuvdagi bilan aynan bir xil bo'lishi kerak.
Token olish
Kodni server tomonida token'ga almashtiring. Tez sinov uchun Instagram Login sozlamalarida App Dashboard ilovaga qo'shilgan akkauntlar uchun 60 kunlik token yaratib bera oladi.
Birinchi so'rov
Instagram Login: GET graph.instagram.com/me?fields=user_id,username. Facebook Login: GET /me/accounts, keyin GET /{page-id}?fields=instagram_business_account.
Ishga tushirishdan oldin
Webhook'larga obuna bo'ling, ilovani Live rejimiga o'tkazing va begona akkauntlar bilan ishlash uchun App Review hamda Business Verification'dan o'ting.
Ikki variant Socialift SDK'da qanday ko'rinadi
Socialift Python SDK'da ikkala variant bitta Instagram klienti bilan ishlaydi — faqat konstruktor va token farq qiladi.
import asyncio, os
from socialift import Facebook, Instagram
async def main():
# 1) Instagram Login: sahifasiz, graph.instagram.com, Instagram User token
async with Instagram.from_env() as ig:
me = await ig.profile(os.environ["IG_USER_TOKEN"])
print(me.username, me.followers_count)
# 2) Facebook Login: Page token + sahifadan olingan IG akkaunt ID
async with Facebook.from_env() as fb, Instagram.via_facebook(
app_secret=os.environ["FACEBOOK_APP_SECRET"]
) as ig_fb:
for page in await fb.pages(os.environ["FB_USER_TOKEN"]):
if page.instagram_id:
posts = await ig_fb.media(page.access_token, ig_user_id=page.instagram_id, limit=5)
print(page.instagram_username, len(posts))
asyncio.run(main())Instagram.from_env() INSTAGRAM_APP_ID va INSTAGRAM_APP_SECRET ni o'qiydi, graph.instagram.com bilan ishlaydi va Instagram User token kutadi.
Instagram.via_facebook(app_secret=...) graph.facebook.com bilan ishlaydi va Page token kutadi. Bu yerda ig_user_id majburiy: graph.facebook.com da me Instagram akkauntni emas, sahifani bildiradi.
SDK har bir so'rovga appsecret_proof qo'shadi, Meta'ning 4, 17, 32, 613 kodlarida RateLimitError (retry_after bilan) ko'taradi va hech narsa saqlamaydi — token'lar sizning bazangizda turadi. Metodlarni real akkauntda sinash uchun kabinetdagi Playground bor.
Ko'p so'raladigan savollar
Instagram API shaxsiy akkaunt bilan ishlaydimi?
Yo'q. Ikkala Instagram API varianti ham faqat professional akkauntlar (Business yoki Creator) bilan ishlaydi. Akkaunt turini Instagram ilovasi sozlamalarida almashtirish mumkin; Facebook Login uchun u Facebook sahifasiga ham bog'lanishi kerak.
Instagram Basic Display API hali ishlaydimi?
Yo'q. Meta uni 2024-yil 4-dekabrda eskirgan deb e'lon qildi va hozir har bir so'rov xato qaytaradi. Professional akkauntlar uchun Instagram API with Instagram Login, ochiq postlarni saytga joylash uchun esa oEmbed ishlatiladi.
Instagram API uchun Facebook sahifasi kerakmi?
Instagram Login variantida kerak emas — u 2024-yil iyulida chiqqan. Sahifa faqat Facebook Login varianti uchun kerak; heshteg qidiruvi, business discovery, mahsulot teglari va partnership ads ham faqat shu variantda.
Instagram API uchun App Review shartmi?
Faqat Advanced Access uchun — ilovangiz sizga tegishli bo'lmagan akkauntlarga xizmat qilsa. App Review har bir ruxsat yoki funksiya uchun alohida o'tadi va Business Verification talab qilinadi. O'z akkauntlaringiz bilan sinov Standard Access'da ishlaydi.
Instagram API limitlari qanday?
Ko'pchilik endpointlar Business Use Case limitiga bo'ysunadi: 24 soatda 4800 × akkaunt impressions soni. Bundan tashqari imkoniyat limitlari bor: sutkasiga 100 ta API post, 7 kunda 30 ta noyob heshteg. Xabarlar uchun soniyabay limitlar amal qiladi.