Instagram 接口参考 | API 文档

选择接口后，仅传入其文档列出的字段。列出可选字段组时，每组至少提供一个字段。分页参数须取自上一页响应，不会自动翻页。

所有接口均使用 GET 查询参数，不接受请求体。版本路径选择 Instagram 接口版本。未知字段或重复字段会被拒绝。用户标识和分页游标须保留为字符串，包括超出 JavaScript 安全整数范围的值。

按成功请求次数计费，不按返回条数计费；每一页单独计费。V1 为 $0.001；V2 为 $0.002；V3 为 $0.008，但三个短码工具接口为 $0.002。账户专属价格优先。供应商按用量提供的折扣不会自动转为客户折扣。上游调用失败会释放预扣，结算失败返回错误且不会再次调用上游。

v1-shortcode_to_media_id

GET https://api.apihop.ai/v1/instagram/v1/media-ids

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`shortcode`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/media-ids" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "shortcode=DRhvwVLAHAG"

v1-media_id_to_shortcode

GET https://api.apihop.ai/v1/instagram/v1/shortcodes

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`media_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/shortcodes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "media_id=3774507992167247878"

v1-user_id_to_username

GET https://api.apihop.ai/v1/instagram/v1/users/username

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`

bash

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

v1-fetch_user_info_by_username

GET https://api.apihop.ai/v1/instagram/v1/users/profile/by-username

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`username`	是	`string`

bash

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

v1-fetch_user_info_by_username_v2

GET https://api.apihop.ai/v1/instagram/v1/users/profile/by-username-v2

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`username`	是	`string`

bash

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

v1-fetch_user_info_by_username_v3

GET https://api.apihop.ai/v1/instagram/v1/users/profile/by-username-v3

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`username`	是	`string`

bash

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

v1-fetch_user_info_by_id

GET https://api.apihop.ai/v1/instagram/v1/users/profile/by-id

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`

bash

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

v1-fetch_user_info_by_id_v2

GET https://api.apihop.ai/v1/instagram/v1/users/profile/by-id-v2

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`

bash

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

v1-fetch_user_about_info

GET https://api.apihop.ai/v1/instagram/v1/users/about

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/users/about" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=182988865"

v1-fetch_user_posts

GET https://api.apihop.ai/v1/instagram/v1/users/posts

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`
`count`	否	`integer`; >= 1; <= 50
`max_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=25025320"

v1-fetch_user_posts_v2

GET https://api.apihop.ai/v1/instagram/v1/users/posts-v2

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`
`count`	否	`integer`; >= 1; <= 50
`end_cursor`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/users/posts-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=25025320"

v1-fetch_user_reels

GET https://api.apihop.ai/v1/instagram/v1/users/reels

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`
`count`	否	`integer`; >= 1; <= 50
`max_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/users/reels" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=25025320"

v1-fetch_user_reposts

GET https://api.apihop.ai/v1/instagram/v1/users/reposts

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`
`max_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/users/reposts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=25025320"

v1-fetch_user_tagged_posts

GET https://api.apihop.ai/v1/instagram/v1/users/tagged-posts

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`
`count`	否	`integer`; >= 1; <= 50
`end_cursor`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/users/tagged-posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=25025320"

GET https://api.apihop.ai/v1/instagram/v1/users/related

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`user_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/users/related" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=25025320"

v1-fetch_search

GET https://api.apihop.ai/v1/instagram/v1/search

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`query`	是	`string`
`select`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=taylorswift"

v1-fetch_post_by_url

GET https://api.apihop.ai/v1/instagram/v1/posts/by-url

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`post_url`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/posts/by-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_url=https://www.instagram.com/p/DPwhVB-jo9k/"

v1-fetch_post_by_url_v2

GET https://api.apihop.ai/v1/instagram/v1/posts/by-url-v2

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`post_url`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/posts/by-url-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_url=https://www.instagram.com/p/DPwhVB-jo9k/"

v1-fetch_post_by_id

GET https://api.apihop.ai/v1/instagram/v1/posts/by-id

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`post_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/posts/by-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=3742637871112032100"

v1-fetch_post_comments_v2

GET https://api.apihop.ai/v1/instagram/v1/posts/comments-v2

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`media_id`	是	`string`
`sort_order`	否	`string`
`min_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/posts/comments-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "media_id=3766120364183949816"

v1-fetch_comment_replies

GET https://api.apihop.ai/v1/instagram/v1/comments/replies

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`media_id`	是	`string`
`comment_id`	是	`string`
`min_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/comments/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "media_id=3766120364183949816" \
  --data-urlencode "comment_id=17871667485468098"

v1-fetch_music_posts

GET https://api.apihop.ai/v1/instagram/v1/music/posts

每次成功请求价格: $0.001 (1000 credits).

至少提供一个: music_id, music_url.

字段	必填	约束
`music_id`	否	`string`
`music_url`	否	`string`
`max_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/music/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "music_id=564058920086577"

v1-fetch_hashtag_posts

GET https://api.apihop.ai/v1/instagram/v1/hashtags/posts

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`hashtag`	是	`string`
`end_cursor`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/hashtags/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "hashtag=cat"

v1-fetch_location_info

GET https://api.apihop.ai/v1/instagram/v1/locations/info

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`location_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/locations/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "location_id=703457703"

v1-fetch_location_posts

GET https://api.apihop.ai/v1/instagram/v1/locations/posts

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`location_id`	是	`string`
`tab`	否	`string`
`end_cursor`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/locations/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "location_id=703457703"

v1-fetch_cities

GET https://api.apihop.ai/v1/instagram/v1/locations/cities

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`country_code`	是	`string`
`page`	否	`integer`; >= 1

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/locations/cities" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "country_code=US"

v1-fetch_locations

GET https://api.apihop.ai/v1/instagram/v1/locations

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`city_id`	是	`string`
`page`	否	`integer`; >= 1

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/locations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "city_id=c2791472"

v1-fetch_explore_sections

GET https://api.apihop.ai/v1/instagram/v1/explore/sections

每次成功请求价格: $0.001 (1000 credits).

无需查询参数。

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/explore/sections" \
  -H "Authorization: Bearer YOUR_API_KEY"

v1-fetch_section_posts

GET https://api.apihop.ai/v1/instagram/v1/explore/sections/posts

每次成功请求价格: $0.001 (1000 credits).

字段	必填	约束
`section_id`	是	`string`
`count`	否	`integer`; >= 1; <= 50
`max_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v1/explore/sections/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "section_id=10156104410190727"

v2-shortcode_to_media_id

GET https://api.apihop.ai/v1/instagram/v2/media-ids

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`shortcode`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/media-ids" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "shortcode=DRhvwVLAHAG"

v2-media_id_to_shortcode

GET https://api.apihop.ai/v1/instagram/v2/shortcodes

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`media_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/shortcodes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "media_id=3774507992167247878"

v2-user_id_to_username

GET https://api.apihop.ai/v1/instagram/v2/users/username

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`user_id`	是	`string`

bash

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

v2-fetch_user_info

GET https://api.apihop.ai/v1/instagram/v2/users/profile

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`

bash

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

v2-fetch_user_posts

GET https://api.apihop.ai/v1/instagram/v2/users/posts

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`
`pagination_token`	否	`string`

bash

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

v2-fetch_user_reels

GET https://api.apihop.ai/v1/instagram/v2/users/reels

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`
`pagination_token`	否	`string`

bash

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

v2-fetch_user_followers

GET https://api.apihop.ai/v1/instagram/v2/users/followers

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`
`pagination_token`	否	`string`

bash

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

v2-fetch_user_following

GET https://api.apihop.ai/v1/instagram/v2/users/following

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`
`pagination_token`	否	`string`

bash

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

v2-fetch_user_stories

GET https://api.apihop.ai/v1/instagram/v2/users/stories

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`

bash

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

v2-fetch_user_highlights

GET https://api.apihop.ai/v1/instagram/v2/users/highlights

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`

bash

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

v2-fetch_highlight_stories

GET https://api.apihop.ai/v1/instagram/v2/highlights/stories

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`highlight_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/highlights/stories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "highlight_id=17895069621772257"

v2-fetch_user_tagged_posts

GET https://api.apihop.ai/v1/instagram/v2/users/tagged-posts

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`
`pagination_token`	否	`string`

bash

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

v2-fetch_similar_users

GET https://api.apihop.ai/v1/instagram/v2/users/similar

每次成功请求价格: $0.002 (2000 credits).

至少提供一个: username, user_id.

字段	必填	约束
`username`	否	`string`
`user_id`	否	`string`

bash

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

v2-search_users

GET https://api.apihop.ai/v1/instagram/v2/search/users

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`keyword`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/search/users" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=instagram"

v2-general_search

GET https://api.apihop.ai/v1/instagram/v2/search

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`keyword`	是	`string`
`pagination_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=cat"

v2-search_reels

GET https://api.apihop.ai/v1/instagram/v2/search/reels

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`keyword`	是	`string`
`pagination_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/search/reels" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=cat"

v2-search_music

GET https://api.apihop.ai/v1/instagram/v2/search/music

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`keyword`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/search/music" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=happy"

v2-search_hashtags

GET https://api.apihop.ai/v1/instagram/v2/search/hashtags

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`keyword`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/search/hashtags" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=cat"

v2-search_locations

GET https://api.apihop.ai/v1/instagram/v2/search/locations

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`keyword`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/search/locations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=paris"

v2-search_by_coordinates

GET https://api.apihop.ai/v1/instagram/v2/locations/nearby

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`latitude`	是	`number`
`longitude`	是	`number`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/locations/nearby" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "latitude=40.7" \
  --data-urlencode "longitude=-74"

v2-fetch_post_info

GET https://api.apihop.ai/v1/instagram/v2/posts/info

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`code_or_url`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/posts/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "code_or_url=DRhvwVLAHAG"

v2-fetch_post_likes

GET https://api.apihop.ai/v1/instagram/v2/posts/likes

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`code_or_url`	是	`string`
`end_cursor`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/posts/likes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "code_or_url=DRhvwVLAHAG"

v2-fetch_post_comments

GET https://api.apihop.ai/v1/instagram/v2/posts/comments

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`code_or_url`	是	`string`
`sort_by`	否	`string`
`pagination_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "code_or_url=DRhvwVLAHAG"

v2-fetch_comment_replies

GET https://api.apihop.ai/v1/instagram/v2/comments/replies

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`code_or_url`	是	`string`
`comment_id`	是	`string`
`pagination_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/comments/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "code_or_url=DRhvwVLAHAG" \
  --data-urlencode "comment_id=18067775592012345"

v2-fetch_music_posts

GET https://api.apihop.ai/v1/instagram/v2/music/posts

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`audio_canonical_id`	是	`string`
`pagination_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/music/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "audio_canonical_id=564058920086577"

v2-fetch_location_posts

GET https://api.apihop.ai/v1/instagram/v2/locations/posts

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`location_id`	是	`string`
`pagination_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/locations/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "location_id=331004901"

v2-fetch_hashtag_posts

GET https://api.apihop.ai/v1/instagram/v2/hashtags/posts

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`keyword`	是	`string`
`feed_type`	否	`string`
`pagination_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v2/hashtags/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=cat"

v3-search_users

GET https://api.apihop.ai/v1/instagram/v3/search/users

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`query`	是	`string`
`rank_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/search/users" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=justin"

v3-search_hashtags

GET https://api.apihop.ai/v1/instagram/v3/search/hashtags

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`query`	是	`string`
`rank_token`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/search/hashtags" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=fashion"

v3-general_search

GET https://api.apihop.ai/v1/instagram/v3/search

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`query`	是	`string`
`next_max_id`	否	`string`
`rank_token`	否	`string`
`enable_metadata`	否	`boolean`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "query=justin"

v3-get_user_id_by_username

GET https://api.apihop.ai/v1/instagram/v3/users/id

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/users/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=liensue.talks"

v3-user_id_to_username

GET https://api.apihop.ai/v1/instagram/v3/users/username

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`user_id`	是	`string`

bash

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

v3-get_user_profile

GET https://api.apihop.ai/v1/instagram/v3/users/profile

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`

bash

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

v3-get_user_brief

GET https://api.apihop.ai/v1/instagram/v3/users/brief

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`user_id`	是	`string`
`username`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/users/brief" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=791258468" \
  --data-urlencode "username=99brasil"

v3-get_user_posts

GET https://api.apihop.ai/v1/instagram/v3/users/posts

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`
`first`	否	`integer`; >= 1; <= 50
`after`	否	`string`
`before`	否	`string`
`last`	否	`integer`
`count`	否	`integer`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/users/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "username=99brasil"

v3-get_user_tagged_posts

GET https://api.apihop.ai/v1/instagram/v3/users/tagged-posts

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`
`first`	否	`integer`; >= 1; <= 50
`after`	否	`string`
`before`	否	`string`
`last`	否	`integer`
`count`	否	`integer`

bash

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

v3-get_user_reels

GET https://api.apihop.ai/v1/instagram/v3/users/reels

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`
`first`	否	`integer`; >= 1; <= 50
`after`	否	`string`
`before`	否	`string`
`last`	否	`integer`
`page_size`	否	`integer`

bash

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

v3-get_user_highlights

GET https://api.apihop.ai/v1/instagram/v3/users/highlights

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`
`first`	否	`integer`; >= 1; <= 50
`after`	否	`string`
`before`	否	`string`
`last`	否	`integer`

bash

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

v3-get_highlight_stories

GET https://api.apihop.ai/v1/instagram/v3/highlights/stories

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`highlight_id`	是	`string`
`reel_ids`	否	`string`
`first`	否	`integer`
`last`	否	`integer`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/highlights/stories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "highlight_id=highlight:18064916456320419"

v3-get_user_about

GET https://api.apihop.ai/v1/instagram/v3/users/about

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`

bash

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

v3-get_user_former_usernames

GET https://api.apihop.ai/v1/instagram/v3/users/former-usernames

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`

bash

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

v3-get_user_stories

GET https://api.apihop.ai/v1/instagram/v3/users/stories

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`

bash

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

v3-get_recommended_reels

GET https://api.apihop.ai/v1/instagram/v3/reels/recommended

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`first`	否	`integer`; >= 1; <= 50
`after`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/reels/recommended" \
  -H "Authorization: Bearer YOUR_API_KEY"

v3-get_post_info

GET https://api.apihop.ai/v1/instagram/v3/posts/info

每次成功请求价格: $0.008 (8000 credits).

至少提供一个: media_id, url.

字段	必填	约束
`media_id`	否	`string`
`url`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/posts/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "media_id=3850699893338385742"

v3-get_post_info_by_code

GET https://api.apihop.ai/v1/instagram/v3/posts/by-code

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`code`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/posts/by-code" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "code=DUajw4YkorV"

v3-get_post_comments

GET https://api.apihop.ai/v1/instagram/v3/posts/comments

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`code`	是	`string`
`min_id`	否	`string`
`sort_order`	否	`string`; `popular`, `newest`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "code=DUajw4YkorV"

v3-get_comment_replies

GET https://api.apihop.ai/v1/instagram/v3/comments/replies

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`media_id`	是	`string`
`comment_id`	是	`string`
`min_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/comments/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "media_id=3829530490739515971" \
  --data-urlencode "comment_id=18065937092249736"

v3-get_post_oembed

GET https://api.apihop.ai/v1/instagram/v3/posts/oembed

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`url`	是	`string`
`hidecaption`	否	`boolean`
`maxwidth`	否	`integer`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/posts/oembed" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.instagram.com/reel/DUlObENDmJD"

v3-translate_comment

GET https://api.apihop.ai/v1/instagram/v3/comments/translation

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`comment_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/comments/translation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "comment_id=18191961100350646"

v3-bulk_translate_comments

GET https://api.apihop.ai/v1/instagram/v3/comments/translations

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`comment_ids`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/comments/translations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "comment_ids=18099342953509681"

v3-get_explore

GET https://api.apihop.ai/v1/instagram/v3/explore

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`max_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/explore" \
  -H "Authorization: Bearer YOUR_API_KEY"

v3-get_user_following

GET https://api.apihop.ai/v1/instagram/v3/users/following

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`
`count`	否	`integer`; >= 1; <= 100
`max_id`	否	`string`

bash

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

v3-get_user_followers

GET https://api.apihop.ai/v1/instagram/v3/users/followers

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`username`	是	`string`
`count`	否	`integer`; >= 1; <= 100
`max_id`	否	`string`

bash

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

v3-get_location_info

GET https://api.apihop.ai/v1/instagram/v3/locations/info

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`location_id`	是	`string`
`show_nearby`	否	`boolean`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/locations/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "location_id=1016248898"

v3-get_location_posts

GET https://api.apihop.ai/v1/instagram/v3/locations/posts

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`location_id`	是	`string`
`tab`	否	`string`; `ranked`, `recent`
`first`	否	`integer`; >= 1; <= 50
`after`	否	`string`
`page_size_override`	否	`integer`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/locations/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "location_id=1016248898"

v3-get_location_nearby

GET https://api.apihop.ai/v1/instagram/v3/locations/nearby-content

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`location_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/locations/nearby-content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "location_id=213385402"

v3-shortcode_to_media_id

GET https://api.apihop.ai/v1/instagram/v3/media-ids

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`shortcode`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/media-ids" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "shortcode=CrgVBtHrFHm"

v3-media_id_to_shortcode

GET https://api.apihop.ai/v1/instagram/v3/shortcodes

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`media_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/shortcodes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "media_id=3850699893338385742"

v3-extract_shortcode

GET https://api.apihop.ai/v1/instagram/v3/shortcodes/from-url

每次成功请求价格: $0.002 (2000 credits).

字段	必填	约束
`url`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/shortcodes/from-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "url=https://www.instagram.com/p/CrgVBtHrFHm/"

v3-get_post_likes

GET https://api.apihop.ai/v1/instagram/v3/posts/likes

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`code`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/posts/likes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "code=DavSf9yS6wy"

v3-get_similar_users

GET https://api.apihop.ai/v1/instagram/v3/users/similar

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`user_id`	是	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/users/similar" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "user_id=25025320"

v3-search_by_coordinates

GET https://api.apihop.ai/v1/instagram/v3/locations/nearby

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`latitude`	是	`number`
`longitude`	是	`number`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/locations/nearby" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "latitude=40.7" \
  --data-urlencode "longitude=-74"

v3-get_hashtag_posts

GET https://api.apihop.ai/v1/instagram/v3/hashtags/posts

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`tag`	是	`string`
`max_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/hashtags/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "tag=cat"

v3-get_music_posts

GET https://api.apihop.ai/v1/instagram/v3/music/posts

每次成功请求价格: $0.008 (8000 credits).

字段	必填	约束
`audio_cluster_id`	是	`string`
`max_id`	否	`string`

bash

curl --get "https://api.apihop.ai/v1/instagram/v3/music/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "audio_cluster_id=18066165960103621"

响应

保留原始 JSON 响应及其 code/data 结构与数字精度。各接口的数据结构不同。成功返回空结果也可能计费，错误不能视为空结果。以下为说明性示例，不是实时响应。

json

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

错误

平台以 HTTP 400 表示参数错误、401 表示鉴权失败、402 表示余额不足、403 表示无网关权限、429 表示限流、5xx 表示服务或供应商故障。排查时请保留 X-Request-Id。上游 HTTP 200 中的失败业务码不代表成功。

来源

接口与价格于 2026-10-31 按官方接口定义和实时价格元数据核对。文字说明与实时元数据冲突时，以实时元数据为准。

TikHub · OpenAPI · Prices