Instagram: API danych | Dokumentacja 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)

Odczytuj profile Instagram, posty, Reels, relacje, komentarze, obserwujących, lokalizacje i wyniki wyszukiwania przez 93 uwierzytelnione punkty końcowe.

Uwierzytelnianie

Użyj klucza API API Hop w nagłówku uwierzytelnienia. Dostępność zależy od włączonych bram i uprawnień klucza API; sama dokumentacja nie potwierdza dostępności produkcyjnej.

http

Authorization: Bearer YOUR_API_KEY

Żądania

Wszystkie operacje używają parametrów zapytania GET bez treści żądania. Segment wersji wybiera wersję interfejsu Instagram. Nieznane lub zdublowane pola są odrzucane. Zachowuj identyfikatory i kursory stronicowania jako ciągi znaków, także wartości większe niż bezpieczny zakres liczb 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"

Odpowiedzi

Natywna odpowiedź JSON zostaje zachowana, w tym opakowanie code/data i precyzja liczb. Struktury różnią się według operacji. Puste udane wyniki mogą podlegać opłacie; błąd nie jest pustym wynikiem. Poniższy przykład jest ilustracyjny, a nie odpowiedzią na żywo.

json

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

Rozliczenia i stronicowanie

Ceny dotyczą udanego żądania, a nie zwróconej pozycji. Każda strona jest osobnym żądaniem. V1 kosztuje $0.001; V2 $0.002; V3 $0.008 z wyjątkiem trzech narzędzi shortcode kosztujących $0.002. Pierwszeństwo mają ceny indywidualne konta. Rabaty ilościowe dostawcy nie są automatycznie przenoszone. Nieudane wywołania dostawcy zwalniają rezerwację; błędy rozliczenia zwracają błąd i nie wywołują drugiego żądania do dostawcy.

Opis punktów końcowych

Wybierz punkt końcowy i wyślij tylko jego udokumentowane pola. Gdy wymieniono alternatywy, podaj co najmniej jedno pole z każdej grupy. Wartości stronicowania muszą pochodzić z poprzedniej odpowiedzi; nie ma automatycznego stronicowania.

Pełny opis punktów końcowych

Błędy

Błędy platformy używają HTTP 400 dla nieprawidłowych parametrów, 401 dla nieprawidłowego uwierzytelnienia, 402 dla niewystarczających środków, 403 dla odmowy dostępu do bramy, 429 dla limitów częstotliwości i 5xx dla błędów usługi lub dostawcy. Zachowaj X-Request-Id do diagnozy. Nie traktuj HTTP 200 od dostawcy z kodem błędu biznesowego jako sukcesu.

Źródła

Listę punktów końcowych i ceny sprawdzono względem oficjalnego schematu i aktualnych metadanych cen 2026-10-31. Aktualne metadane mają pierwszeństwo przed sprzecznymi cenami w opisie.

TikHub · OpenAPI · Ceny