API dữ liệu Instagram | Tài liệu 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)

Đọc hồ sơ Instagram, bài đăng, Reels, tin, bình luận, người theo dõi, vị trí và kết quả tìm kiếm qua 93 điểm cuối có xác thực.

Xác thực

Dùng khóa API API Hop trong tiêu đề xác thực. Khả năng truy cập phụ thuộc cổng đã bật và quyền của khóa API; chỉ riêng tài liệu không xác nhận khả dụng trên môi trường sản xuất.

http

Authorization: Bearer YOUR_API_KEY

Yêu cầu

Mọi thao tác dùng tham số truy vấn GET, không có thân yêu cầu. Đoạn phiên bản chọn phiên bản giao diện Instagram. Trường không rõ hoặc trùng lặp bị từ chối. Giữ mã định danh và con trỏ phân trang dưới dạng chuỗi, kể cả giá trị lớn hơn phạm vi số JavaScript có thể biểu diễn an toàn.

bash

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

Phản hồi

Phản hồi JSON gốc được giữ nguyên, gồm lớp bao code/data và độ chính xác số. Cấu trúc khác nhau theo thao tác. Kết quả rỗng thành công có thể tính phí; lỗi không phải kết quả rỗng. Ví dụ sau chỉ minh họa, không phải phản hồi trực tiếp.

json

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

Tính phí và phân trang

Giá tính theo mỗi yêu cầu thành công, không theo mỗi mục trả về. Mỗi trang là một yêu cầu riêng. V1 có giá $0.001; V2 có giá $0.002; V3 có giá $0.008, trừ ba tiện ích shortcode có giá $0.002. Giá riêng của tài khoản được ưu tiên. Chiết khấu số lượng của nhà cung cấp không tự động được chuyển cho khách hàng. Lời gọi thượng nguồn thất bại sẽ giải phóng khoản giữ chỗ; lỗi quyết toán trả lỗi và không kích hoạt yêu cầu thượng nguồn thứ hai.

Tham chiếu

Chọn một điểm cuối và chỉ gửi các trường được mô tả. Khi có lựa chọn thay thế, cung cấp ít nhất một trường trong mỗi nhóm. Giá trị phân trang phải lấy từ phản hồi trước; không có phân trang tự động.

Tham chiếu đầy đủ

Lỗi

Lỗi nền tảng dùng HTTP 400 cho tham số không hợp lệ, 401 cho xác thực không hợp lệ, 402 cho thiếu tín dụng, 403 cho truy cập cổng bị từ chối, 429 cho giới hạn tốc độ và 5xx cho lỗi dịch vụ hoặc nhà cung cấp. Giữ X-Request-Id để khắc phục. Không coi HTTP 200 thượng nguồn có mã nghiệp vụ thất bại là thành công.

Nguồn

Danh sách điểm cuối và giá được đối chiếu với lược đồ chính thức và siêu dữ liệu giá trực tiếp ngày 2026-10-31. Siêu dữ liệu trực tiếp được ưu tiên hơn giá mâu thuẫn trong phần mô tả.

TikHub · OpenAPI · Giá