Instagram API
Retrieve public Instagram profiles, posts, reels, stories, highlights, comments, likes, locations, music, and hashtags.
14 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Location
2 endpoints- Get Instagram location detailsReturns 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 crGET - List Instagram location media (retired)Retired: always returns 410 and is not charged. Use /v1/instagram/location/posts instead.
/v1/instagram/location/media1 crGET
Post
4 endpoints- Get Instagram oEmbed dataReturns 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 crGET - Get Instagram postReturns 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 crGET - Get Instagram post by media IDReturns public media details and the first page of comments for one Instagram post. Requires the numeric media_id.
/v1/instagram/post/by-id1 crGET - List Instagram post commentsLists 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 crGET
Search
1 endpointUser
7 endpoints- Get Instagram profile summary by IDReturns 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 crGET - Get Instagram user ID by usernameReturns 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 crGET - Get Instagram user profileReturns profile data for a public Instagram account from username_or_url. detail=summary returns identity, bio, links, and counts; detail=full adds post previews and business fields. Check is_partial on the response.
/v1/instagram/user/info1 crGET - List Instagram stories and highlightsReturns 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 crGET - List Instagram user postsLists 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 crGET - List Instagram user posts by IDLists 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 crGET - List Instagram user reelsLists reels from a public Instagram account by numeric user_id. count sets the page size; pass the previous response's paging_info.max_id as cursor to get the next page.
/v1/instagram/user/reels1 crGET
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/search/top?keyword=<keyword>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.