API Data Instagram | Dokumentasi 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)

Baca profil Instagram, postingan, Reels, Stories, komentar, pengikut, lokasi, dan hasil pencarian melalui 93 endpoint yang memerlukan autentikasi.

Autentikasi

Gunakan kunci API API Hop Anda dalam header otorisasi. Ketersediaan bergantung pada gateway yang diaktifkan dan izin kunci API; dokumentasi saja tidak mengonfirmasi ketersediaan produksi.

http

Authorization: Bearer YOUR_API_KEY

Permintaan

Semua operasi menggunakan parameter kueri GET tanpa isi permintaan. Segmen versi memilih versi antarmuka Instagram. Kolom yang tidak dikenal atau duplikat ditolak. Simpan pengenal dan kursor paginasi sebagai string, termasuk nilai yang lebih besar daripada angka yang dapat direpresentasikan JavaScript secara aman.

bash

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

Respons

Respons JSON asli dipertahankan, termasuk pembungkus code/data dan presisi angkanya. Struktur berbeda menurut operasi. Hasil kosong yang berhasil dapat dikenai biaya; kesalahan bukan hasil kosong. Contoh berikut bersifat ilustratif, bukan respons langsung.

json

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

Penagihan dan paginasi

Harga berlaku per permintaan yang berhasil, bukan per item yang dikembalikan. Setiap halaman merupakan permintaan terpisah. V1 berharga $0.001; V2 berharga $0.002; V3 berharga $0.008 kecuali tiga utilitas shortcode yang berharga $0.002. Harga khusus akun berlaku lebih dahulu. Diskon volume penyedia tidak otomatis diteruskan kepada pelanggan. Panggilan hulu yang gagal melepaskan cadangan; kegagalan penyelesaian biaya mengembalikan kesalahan dan tidak memicu permintaan hulu kedua.

Referensi

Pilih endpoint dan kirim hanya kolom yang didokumentasikan. Jika alternatif dicantumkan, berikan setidaknya satu kolom dari setiap kelompok. Nilai paginasi harus berasal dari respons sebelumnya; tidak ada paginasi otomatis.

Referensi lengkap

Kesalahan

Kesalahan platform menggunakan HTTP 400 untuk parameter tidak valid, 401 untuk autentikasi tidak valid, 402 untuk kredit tidak cukup, 403 untuk akses gateway yang ditolak, 429 untuk batas laju, dan 5xx untuk kegagalan layanan atau penyedia. Simpan X-Request-Id untuk pemecahan masalah. Jangan menganggap HTTP 200 dari penyedia hulu dengan kode bisnis gagal sebagai keberhasilan.

Sumber

Daftar endpoint dan harga diperiksa terhadap skema resmi dan metadata harga langsung pada 2026-10-31. Metadata langsung berlaku lebih dahulu jika bertentangan dengan harga dalam uraian teks.

TikHub · OpenAPI · Harga