واجهة بيانات Instagram | وثائق API

# Instagram Data API

Read Instagram profiles, posts, Reels, stories, comments, followers, locations, and search results through 93 authenticated endpoints.

## Authentication

Use your API Hop API key in the authorization header. Availability depends on enabled gateways and API key permissions; documentation alone does not confirm production availability.

```http
Authorization: Bearer YOUR_API_KEY
```

## Requests

All operations use GET query parameters without a request body. The version segment selects the Instagram interface version. Unknown or duplicate fields are rejected. Keep identifiers and pagination cursors as strings, including values larger than JavaScript can safely represent as numbers.

```bash
curl --get "https://api.apihop.ai/v1/instagram/v1/users/profile/by-username" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=instagram"
```

## Responses

The native JSON response is preserved, including its code/data envelope and numeric precision. Shapes differ by operation. Empty successful results can be billable; an error is not an empty result. The following example is illustrative, not a live response.

```json
{"code":200,"data":{"user":{"id":"25025320","username":"instagram"}}}
```

## Billing and pagination

Prices are per successful request, not per returned item. Every page is a separate request. V1 costs $0.001; V2 costs $0.002; V3 costs $0.008 except its three shortcode utilities, which cost $0.002. Account-specific prices take precedence. Supplier volume discounts are not automatically passed through. Failed upstream calls release the reservation; settlement failures return an error and do not trigger a second upstream request.

## Reference

Select an endpoint and send only its documented fields. When alternatives are listed, provide at least one field from each group. Pagination values must come from the preceding response; there is no automatic pagination.

[Complete reference](https://apihop.ai/en/docs/api-reference/instagram/reference)

## Errors

Platform errors use HTTP 400 for invalid parameters, 401 for invalid authentication, 402 for insufficient credit, 403 for denied gateway access, 429 for rate limits, and 5xx for service or supplier failures. Keep X-Request-Id for troubleshooting. Do not treat an upstream HTTP 200 with a failed business code as success.

## Sources

The endpoint list and prices were checked against the official schema and live price metadata on 2026-10-31. Live metadata takes precedence over conflicting prose prices.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

اقرأ ملفات Instagram والمنشورات ومقاطع Reels والقصص والتعليقات والمتابعين والمواقع ونتائج البحث عبر 93 نقطة نهاية تتطلب المصادقة.

المصادقة

استخدم مفتاح API Hop API في ترويسة المصادقة. تعتمد الإتاحة على البوابات المفعلة وصلاحيات مفتاح API؛ والوثائق وحدها لا تؤكد الإتاحة في الإنتاج.

http

Authorization: Bearer YOUR_API_KEY

الطلبات

تستخدم جميع العمليات معاملات استعلام GET دون جسم طلب. يحدد مقطع الإصدار نسخة واجهة Instagram. ترفض الحقول المجهولة أو المكررة. احتفظ بالمعرفات ومؤشرات الصفحات كسلاسل نصية، بما فيها القيم الأكبر مما يستطيع JavaScript تمثيله بأمان كأرقام.

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/users/profile/by-username" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=instagram"

الاستجابات

تحفظ استجابة JSON الأصلية، بما فيها غلاف code/data والدقة العددية. تختلف البنية بحسب العملية. قد تحتسب رسوم للنتائج الفارغة الناجحة؛ والخطأ ليس نتيجة فارغة. المثال التالي توضيحي، وليس استجابة مباشرة.

json

{"code":200,"data":{"user":{"id":"25025320","username":"instagram"}}}

الفوترة وترقيم الصفحات

الأسعار لكل طلب ناجح، وليست لكل عنصر معاد. كل صفحة طلب مستقل. تكلفة V1 هي $0.001؛ وV2 هي $0.002؛ وV3 هي $0.008 باستثناء أدوات shortcode الثلاث التي تكلف $0.002. لأسعار الحساب الخاصة الأولوية. لا تمرر خصومات حجم الاستخدام لدى المزود تلقائيا. تحرر الاستدعاءات الفاشلة لدى المزود المبلغ المحجوز؛ وتعيد إخفاقات التسوية خطأ ولا تطلق طلبا ثانيا إلى المزود.

المرجع

اختر نقطة نهاية وأرسل حقولها الموثقة فقط. عند سرد بدائل، قدم حقلا واحدا على الأقل من كل مجموعة. يجب أن تأتي قيم ترقيم الصفحات من الاستجابة السابقة؛ ولا يوجد جلب تلقائي للصفحات.

المرجع الكامل

الأخطاء

تستخدم أخطاء المنصة HTTP 400 للمعاملات غير الصحيحة، و401 للمصادقة غير الصحيحة، و402 للرصيد غير الكافي، و403 لرفض الوصول إلى البوابة، و429 لحدود المعدل، و5xx لإخفاقات الخدمة أو المزود. احتفظ بـX-Request-Id للتشخيص. لا تعتبر HTTP 200 من المزود مع رمز أعمال فاشل نجاحا.

المصادر

جرى التحقق من قائمة نقاط النهاية والأسعار مقابل المخطط الرسمي وبيانات الأسعار المباشرة في 2026-10-31. تكون الأولوية للبيانات المباشرة عند تعارضها مع الأسعار الواردة في النص.

TikHub · OpenAPI · الأسعار