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