Instagram endpoint reference | API Docs

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.

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.

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.

v1-shortcode_to_media_id

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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`shortcode`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`media_id`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`username`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`username`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`username`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`string`
`count`	No	`integer`; >= 1; <= 50
`max_id`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`string`
`count`	No	`integer`; >= 1; <= 50
`end_cursor`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`string`
`count`	No	`integer`; >= 1; <= 50
`max_id`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`string`
`max_id`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`string`
`count`	No	`integer`; >= 1; <= 50
`end_cursor`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`user_id`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`query`	Yes	`string`
`select`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`post_url`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`post_url`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`post_id`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`media_id`	Yes	`string`
`sort_order`	No	`string`
`min_id`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`media_id`	Yes	`string`
`comment_id`	Yes	`string`
`min_id`	No	`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

Price per successful request: $0.001 (1000 credits).

At least one: music_id, music_url.

Field	Required	Contract
`music_id`	No	`string`
`music_url`	No	`string`
`max_id`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`hashtag`	Yes	`string`
`end_cursor`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`location_id`	Yes	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`location_id`	Yes	`string`
`tab`	No	`string`
`end_cursor`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`country_code`	Yes	`string`
`page`	No	`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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`city_id`	Yes	`string`
`page`	No	`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

Price per successful request: $0.001 (1000 credits).

No query parameters.

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

Price per successful request: $0.001 (1000 credits).

Field	Required	Contract
`section_id`	Yes	`string`
`count`	No	`integer`; >= 1; <= 50
`max_id`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`shortcode`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`media_id`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`user_id`	Yes	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`highlight_id`	Yes	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

At least one: username, user_id.

Field	Required	Contract
`username`	No	`string`
`user_id`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`keyword`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`keyword`	Yes	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`keyword`	Yes	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`keyword`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`keyword`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`keyword`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`latitude`	Yes	`number`
`longitude`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`code_or_url`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`code_or_url`	Yes	`string`
`end_cursor`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`code_or_url`	Yes	`string`
`sort_by`	No	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`code_or_url`	Yes	`string`
`comment_id`	Yes	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`audio_canonical_id`	Yes	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`location_id`	Yes	`string`
`pagination_token`	No	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`keyword`	Yes	`string`
`feed_type`	No	`string`
`pagination_token`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`query`	Yes	`string`
`rank_token`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`query`	Yes	`string`
`rank_token`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`query`	Yes	`string`
`next_max_id`	No	`string`
`rank_token`	No	`string`
`enable_metadata`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`user_id`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`user_id`	Yes	`string`
`username`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`string`
`first`	No	`integer`; >= 1; <= 50
`after`	No	`string`
`before`	No	`string`
`last`	No	`integer`
`count`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`string`
`first`	No	`integer`; >= 1; <= 50
`after`	No	`string`
`before`	No	`string`
`last`	No	`integer`
`count`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`string`
`first`	No	`integer`; >= 1; <= 50
`after`	No	`string`
`before`	No	`string`
`last`	No	`integer`
`page_size`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`string`
`first`	No	`integer`; >= 1; <= 50
`after`	No	`string`
`before`	No	`string`
`last`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`highlight_id`	Yes	`string`
`reel_ids`	No	`string`
`first`	No	`integer`
`last`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`first`	No	`integer`; >= 1; <= 50
`after`	No	`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

Price per successful request: $0.008 (8000 credits).

At least one: media_id, url.

Field	Required	Contract
`media_id`	No	`string`
`url`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`code`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`code`	Yes	`string`
`min_id`	No	`string`
`sort_order`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`media_id`	Yes	`string`
`comment_id`	Yes	`string`
`min_id`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`url`	Yes	`string`
`hidecaption`	No	`boolean`
`maxwidth`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`comment_id`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`comment_ids`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`max_id`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`string`
`count`	No	`integer`; >= 1; <= 100
`max_id`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`username`	Yes	`string`
`count`	No	`integer`; >= 1; <= 100
`max_id`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`location_id`	Yes	`string`
`show_nearby`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`location_id`	Yes	`string`
`tab`	No	`string`; `ranked`, `recent`
`first`	No	`integer`; >= 1; <= 50
`after`	No	`string`
`page_size_override`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`location_id`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`shortcode`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`media_id`	Yes	`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

Price per successful request: $0.002 (2000 credits).

Field	Required	Contract
`url`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`code`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`user_id`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`latitude`	Yes	`number`
`longitude`	Yes	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`tag`	Yes	`string`
`max_id`	No	`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

Price per successful request: $0.008 (8000 credits).

Field	Required	Contract
`audio_cluster_id`	Yes	`string`
`max_id`	No	`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"

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"}}}

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 · OpenAPI · Prices