Instagram API
Retrieve public Instagram profiles, posts, reels, stories, highlights, comments, likes, locations, music, and hashtags.
85 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Hashtag
3 endpoints- List hashtag posts and Reels (v1)GETPosts and Reels for a hashtag, ranked by relevance as the Instagram app shows them, not by date. The first page holds about 8 items and later pages about 20. A next_cursor expires after 24 hours.
/v1/instagram/hashtag/feed1 cr - List Instagram hashtag media (v2)GETReturns posts for a public Instagram hashtag, in the order Instagram ranks them for a search of that tag, not newest first. Items carry product_type, taken_at, likes, comments, and plays and shares on Reels. Pass the previous next_max_id as max_id for the next page.
/v2/instagram/hashtag/media1 cr - List Instagram hashtag posts (v1)GETTop posts for a hashtag — Instagram's ranked feed, not a chronological one. The response is the hashtag record with its post collections attached, plus the tag's total post count. Page with end_cursor.
/v1/instagram/hashtag/posts3 cr
Location
8 endpoints- Get Instagram location details (v1)GETReturns public details for an Instagram location from required location_id: name, coordinates, category, and media count. Optional slug and show_nearby refine the response.
/v1/instagram/location/info1 cr - List Instagram cities by country (v1)GETCities Instagram lists for a country, as its own place directory. Each entry's id is a c-prefixed string that /location/list takes. Page with page; next_page is null on the last page.
/v1/instagram/location/cities3 cr - List Instagram locations in a city (v1)GETIndividual places within a city — the bottom level of Instagram's place directory — along with the city and country they sit under.
/v1/instagram/location/list3 cr - List Instagram locations near a point (v1)GETPlaces near a latitude/longitude, closest first. Use it to find taggable locations around a point when you have coordinates rather than a name.
/v1/instagram/location/nearby3 cr - List Instagram stories at a location (v2)GETReturns the public stories currently tagged with an Instagram location, identified by location_id. items is empty when the location has no live stories.
/v2/instagram/location/stories1 cr - List location guides (v1)GETGuides that feature a place. A place without guides returns an empty items list.
/v1/instagram/location/guides1 cr - List recent posts at a place (v1)GETList the most recent posts tagged at a place, by location_id. Paginate with cursor and next_cursor. A place with no recent posts returns an empty items list.
/v1/instagram/place/recent1 cr List Instagram location media (retired) (v1)DeprecatedGETRetired: always returns 410 and is not charged. Use /v1/instagram/location/posts instead./v1/instagram/location/media1 cr
Music
2 endpoints- List Instagram posts by audio track (v1)GETReturns reels and posts that use one Instagram audio track, with track metadata and its total use count. Send music_id from /v1/instagram/search/music, or music_url. Page with max_id.
/v1/instagram/music/posts3 cr - Search Instagram audio by name (v1)GETSearch Instagram's audio library by track or artist name. Returns each track's ID, title, artist and duration — the IDs /music/posts takes.
/v1/instagram/music/search3 cr
Post
20 endpoints- Get an Instagram reel transcript (v2)GETReturns the spoken words of a public Instagram reel, identified by code, as text. text is empty when the reel has no speech.
/v2/instagram/media/transcript1 cr - Get comment summary (v1)GETA post's comment count, preview comments and comment settings in one call, without paging through comments.
/v1/instagram/post/comment-summary1 cr - Get Instagram oEmbed data (v1)GETReturns oEmbed data, including embed HTML and a thumbnail, for a public Instagram post or reel url. Optional maxwidth and maxheight (pixels) constrain the embed size.
/v1/instagram/post/oembed1 cr - Get Instagram post (v1)GETReturns public media details and the first page of comments for one Instagram post. Provide the shortcode as code or the numeric media_id; one of the two is required.
/v1/instagram/post1 cr - Get Instagram post by media ID (v1)GETReturns public media details and the first page of comments for one Instagram post. Requires the numeric media_id.
/v1/instagram/post/by-id1 cr - Get Instagram post or reel details (v2)GETReturns the details of one public Instagram post or reel: owner, caption, like_count, comment_count and media. code takes a shortcode, a numeric media ID or the post URL.
/v2/instagram/media/info1 cr - Get Instagram post view counts (v1)GETReturns view counts for a public Instagram reel from its shortcode or URL. video_view_count is the embed view count. play_count is the plays shown on the owner's Reels tab, found only among their 36 newest reels. They are different metrics.
/v1/instagram/post/views1 cr - Get post insights (v1)GETPublic counters Instagram shows for a post. A post without insights returns data: null.
/v1/instagram/post/insights1 cr - Get post or reel (v1)GETGet a post or reel by url or code: caption, media files, like, comment and play counts, owner, tagged users and location. A removed or unavailable post returns data: null.
/v1/instagram/media1 cr - Get Reel audio (v1)GETThe sound a Reel uses: original audio or song, its ID, duration, artist and how many Reels use it. A post without audio returns data: null.
/v1/instagram/reel/audio1 cr - Get Reel template (v1)GETThe template behind a Reel: clip timings and audio. A Reel made without a template returns data: null.
/v1/instagram/reel/template1 cr - List comment likers (v1)GETAccounts that liked a comment. An unknown comment or one without likes returns an empty items list.
/v1/instagram/comment/likers1 cr - List comment replies (v1)GETList the replies to one comment. Send the post as url, code or media_id and the comment's pk as comment_id. Paginate with cursor and next_cursor. A comment without replies returns an empty items list.
/v1/instagram/comments/replies1 cr - List Instagram post comments (v2)GETReturns comments on a public Instagram post or reel, identified by code. sort_type picks popular, recent or verified order. Pass pagination_token from the previous response for the next page.
/v2/instagram/media/comments1 cr - List Instagram post comments (v1)GETLists comments on a public Instagram post, identified by its shortcode in code. count sets the page size; pass page_info.end_cursor from the previous response as cursor to get the next page.
/v1/instagram/post/comments1 cr - List Instagram post likes (v1)GETAccounts that liked a post, as { count, items }. Requires code. Page with end_cursor.
/v1/instagram/post/likes3 cr - List Instagram post likes (v2)GETReturns accounts that liked a public Instagram post or reel, identified by code, with user_count. The route takes no pagination input.
/v2/instagram/media/likes1 cr - List post comments (v1)GETList the comments on a post or reel by url, code or media_id, with the commenter and like count. Paginate with cursor and next_cursor. A post without comments returns an empty items list.
/v1/instagram/comments1 cr - List users tagged in a post (v1)GETAccounts tagged in a post or Reel. A post without tags returns an empty items list.
/v1/instagram/post/tagged-users1 cr Get Instagram media (retired) (v2)DeprecatedGETRetired: always returns 410 and is not charged. Use /media/info for media details and /media/comments for comments./v2/instagram/media/info/web1 cr
Search
10 endpoints- Get Instagram search typeahead (v1)GETInstagram's search-bar typeahead: accounts, hashtags and places for one query, in a single response. Set type to return just one of the three. Not paginated — it returns the first screen of results, the same as the app's search bar.
/v1/instagram/search3 cr - Search Instagram by keyword (v1)GETKeyword search returning mixed results that can be paged with pagination_token, unlike /search. Use it when you need more than the first screen.
/v1/instagram/search/all3 cr - Search Instagram hashtags by keyword (v1)GETSearch hashtags by keyword, with each tag's total post count — useful for sizing a tag before pulling its posts.
/v1/instagram/search/hashtags3 cr - Search Instagram posts by keyword (v2)GETReturns public Instagram posts that match keyword. Pass pagination_token from the previous response for the next page; has_more is false on the last page.
/v2/instagram/search/posts1 cr - Search Instagram reels by keyword (v1)GETReturns public Instagram reels that match keyword in reels_serp_modules. Pass reels_max_id from the previous response for the next page.
/v1/instagram/search/reels1 cr - Search Instagram reels by keyword (v2)GETReturns public Instagram reels that match keyword in reels_serp_modules. Pass reels_max_id from the previous response for the next page.
/v2/instagram/search/reels1 cr - Search Instagram top media by keyword (v1)GETSearches public Instagram media for required keyword and returns top posts plus related keywords. media_count and related_keywords_count set result sizes; cursor pages.
/v1/instagram/search/top1 cr - Search Instagram users by keyword (v1)GETReturns public Instagram accounts that match keyword, each with its rank in position and a user object.
/v1/instagram/search/users1 cr - Search Instagram users by keyword (v2)GETReturns public Instagram accounts that match keyword, each with its rank in position and a user object.
/v2/instagram/search/users1 cr - Search places (v1)GETSearch Instagram places by name. Each result has a title, a subtitle, and the place's location with the ID that /v1/instagram/place/recent takes. No match returns an empty items list.
/v1/instagram/place/search1 cr
Shop
3 endpoints- Get shop (v1)GETAn account's shop: merchant IDs, collections and the first products. Pass a collection id to /v1/instagram/shop/collection/products. An account without a shop returns data: null.
/v1/instagram/shop2 cr - Get shop details (v1)GETA shop's seller name, business address, contacts and privacy policy link. An account without a shop returns data: null.
/v1/instagram/shop/about2 cr - List collection products (v1)GETProducts in one shop collection, with name, price and images. A next_cursor is valid for 24 hours.
/v1/instagram/shop/collection/products1 cr
User
36 endpoints- Check if an Instagram account is live (v2)GETReturns is_live for a public Instagram account, identified by username_or_id, and the live broadcast when it is streaming.
/v2/instagram/user/live1 cr - Get account country and join date (v1)GETGet an account's About panel by numeric user_id: verification, country, the month it joined, and former usernames. An unknown ID returns data: null.
/v1/instagram/profile/about1 cr - Get Instagram highlight stories (v2)GETReturns the media items in one Instagram highlight reel, with its title and media_count. highlight_id comes from the id of a user highlights result.
/v2/instagram/highlight/stories1 cr - Get Instagram profile summary by ID (v1)GETReturns identity, biography, links, and follower and following counts for a public Instagram account. Requires the numeric user_id, which Get User ID returns.
/v1/instagram/user/summary1 cr - Get Instagram user ID by username (v1)GETReturns the numeric user ID and basic identity fields for a public Instagram account, from required username_or_url. Use the ID with the endpoints that take user_id.
/v1/instagram/user/id1 cr - Get Instagram user profile (v1)GETReturns profile data for a public Instagram account from username_or_url: identity, bio, links, and counts. detail=full returns the same fields marked is_partial: true; Instagram no longer serves post previews or business fields logged out.
/v1/instagram/user/info1 cr - Get Instagram username by user ID (v1)GETResolves a numeric user_id to the account's current username, with a small profile stub (display name, avatar, verification). Useful for re-checking IDs you stored earlier, since usernames change but IDs do not.
/v1/instagram/user/username3 cr - Get profile (v1)GETGet an account's public profile: name, bio, links, follower, following and post counts, and verification and privacy flags. Returns the numeric pk that other routes take as user_id. An unknown username returns data: null.
/v1/instagram/profile1 cr - Get story (v1)GETGet one story by its link or ID: media URLs, taken_at, expiring_at and the owner. An expired or unknown story returns data: null.
/v1/instagram/story1 cr - List accounts an Instagram user follows (v2)GETReturns accounts that a public Instagram profile follows, identified by username_or_id, with total_followings. Pass max_id from the previous response's next_max_id for the next page.
/v2/instagram/user/following1 cr - List businesses related to an account (v2)GETReturns business accounts Instagram suggests alongside a public profile, identified by username_or_id, each with its user and recent media_previews.
/v2/instagram/user/businesses1 cr - List highlight stories (v1)GETList the stories saved in one highlight, with the highlight's title, cover and owner. An unknown or removed highlight returns data: null.
/v1/instagram/highlight/stories1 cr - List Instagram stories and highlights (v1)GETReturns story availability, live status, and highlight metadata for a public Instagram account. Requires user_id; the include_ flags turn extra response sections on or off.
/v1/instagram/user/highlights1 cr - List Instagram tagged posts (v1)GETReturns posts that tag a public Instagram profile, identified by username_or_id, with total_count. Pass max_id from the previous response's next_max_id for the next page.
/v1/instagram/user/tagged-posts1 cr - List Instagram tagged posts (v2)GETReturns posts that tag a public Instagram profile, identified by username_or_id, with total_count. Pass max_id from the previous response's next_max_id for the next page.
/v2/instagram/user/tagged-posts1 cr - List Instagram user followers (v2)GETReturns accounts that follow a public Instagram profile, identified by username_or_id, with the total in count. Pass end_cursor from the previous response's page_info.end_cursor for the next page.
/v2/instagram/user/followers1 cr - List Instagram user highlights (v2)GETReturns the highlight reels pinned to a public Instagram profile, identified by username_or_id, with each highlight's id, title and cover. Pass an id to the highlight stories route for its media.
/v2/instagram/user/highlights1 cr - List Instagram user posts (v1)GETLists media from a public Instagram account. Provide username_or_url or user_id. count sets the page size; pass the previous response's next_max_id as cursor to get the next page.
/v1/instagram/user/posts1 cr - List Instagram user posts (v2)GETReturns recent posts from a public Instagram profile, identified by username_or_id. count sets the page size. Pass max_id from the previous response's next_max_id for the next page.
/v2/instagram/user/posts1 cr - List Instagram user posts by ID (v1)GETLists media from a public Instagram account by numeric user_id. count sets the page size; pass the previous response's next_max_id as next_max_id to get the next page.
/v1/instagram/user/posts/by-id1 cr - List Instagram user reels (v1)GETLists reels from a public Instagram account by username_or_url or user_id, 12 per page. Each reel includes play_count, the plays shown on the Reels tab. detail=summary returns lighter entries. Pass paging_info.max_id as cursor for the next page.
/v1/instagram/user/reels1 cr - List Instagram user reels (v2)GETReturns reels from a public Instagram profile, identified by username_or_id. Pass max_id from the previous response's paging_info.max_id for the next page.
/v2/instagram/user/reels1 cr - List Instagram user reposts (v1)GETPosts this account has reposted onto its own profile, newest first. Page with max_id from next_max_id.
/v1/instagram/user/reposts3 cr - List Instagram user stories (v2)GETReturns the stories currently live on a public Instagram profile, identified by username_or_id.
/v2/instagram/user/stories1 cr - List pinned posts (v1)GETThe posts an account pinned to the top of its grid. An account without pinned posts returns an empty items list.
/v1/instagram/user/pinned-posts2 cr - List profile highlights (v1)GETList an account's story highlights, by username or user_id. Paginate with cursor and next_cursor. An account without highlights returns an empty items list.
/v1/instagram/profile/highlights3 cr - List profile stories (v1)GETList the stories live on an account, by username or user_id. Stories expire after 24 hours, so an account with none live returns an empty items list.
/v1/instagram/profile/stories3 cr - List related Instagram profiles (v1)GETReturns the related accounts Instagram shows on a profile page, for the numeric user_id. Get the ID from the profile route. The response is one list and is not paginated.
/v1/instagram/user/related3 cr - List similar businesses (v1)GETAccounts Instagram recommends in the same business category as this account. A personal account returns an empty items list.
/v1/instagram/user/similar-businesses2 cr - List similar Instagram users (v2)GETReturns accounts that Instagram suggests as similar to a public profile, identified by username_or_id. The response is a single list in users and is not paginated.
/v2/instagram/user/similar1 cr - Search an Instagram user's following (v2)GETReturns accounts that a public Instagram profile, identified by username_or_id, follows and that match keyword.
/v2/instagram/user/following/search1 cr - Search followers (v1)GETFind an account's followers whose username or full name matches query. No match returns an empty items list.
/v1/instagram/user/followers/search2 cr - Search following (v1)GETFind accounts this account follows whose username or full name matches query. No match returns an empty items list.
/v1/instagram/user/following/search2 cr List accounts an Instagram user follows (v3)DeprecatedGETDeprecated: use /v1/instagram/user/following instead. Accounts this user follows, as { count, items }. Page with pagination_token from the previous response./v3/instagram/user/following3 crList Instagram user followers (v3)DeprecatedGETDeprecated: use /v1/instagram/user/followers instead. Accounts that follow this user, as { count, items }. Pass pagination_token from the previous response for the next page./v3/instagram/user/followers3 crList similar Instagram users (v3)DeprecatedGETDeprecated: use /v1/instagram/user/similar instead. Accounts Instagram recommends as similar to this one. A different set from /user/related, generally larger, and this route accepts a username as well as a numeric ID./v3/instagram/user/similar3 cr
Utility
3 endpoints- Convert Instagram media ID to shortcode (v1)GETConverts a numeric media ID back into the shortcode used in post URLs, so you can rebuild a link to a post you only have an ID for.
/v1/instagram/util/shortcode3 cr - Convert Instagram shortcode to media ID (v1)GETConverts the shortcode in a post URL (the DcBr7X4SL3h in instagram.com/p/DcBr7X4SL3h/) into the numeric media ID that /post/by-id takes.
/v1/instagram/util/media-id3 cr - Resolve share link (v1)GETTurn an instagram.com/s/ share link into what it points to: the story or highlight pk and its type.
/v1/instagram/share/resolve1 cr
What you can build
- Compare creator profiles and public engagement counts.
- Collect posts and comments for campaign research.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v1/instagram/music/search?keyword=<keyword>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.