Instagram V2 API
Retrieve public Instagram posts, reels, stories, highlights, profiles, comments, likes, and hashtag media. Search accounts, posts, and reels by keyword.
17 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Hashtag
1 endpointMedia
4 endpoints- Get Instagram media (retired)Retired: always returns 410 and is not charged. Use /media/info for media details and /media/comments for comments.
/v2/instagram/media/info/web2 crGET - Get Instagram post or reel detailsReturns 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/info2 crGET - List Instagram post commentsReturns 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/comments2 crGET - List Instagram post likesReturns accounts that liked a public Instagram post or reel, identified by code, with user_count. The route takes no pagination input.
/v2/instagram/media/likes2 crGET
Search
3 endpoints- Search Instagram posts by keywordReturns 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/posts2 crGET - Search Instagram reels by keywordReturns 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/reels2 crGET - Search Instagram users by keywordReturns public Instagram accounts that match keyword, each with its rank in position and a user object.
/v2/instagram/search/users2 crGET
User
9 endpoints- Get Instagram highlight storiesReturns 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/stories2 crGET - List accounts an Instagram user followsReturns 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/following2 crGET - List Instagram tagged postsReturns 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-posts2 crGET - List Instagram user followersReturns 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/followers2 crGET - List Instagram user highlightsReturns 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/highlights2 crGET - List Instagram user postsReturns 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/posts2 crGET - List Instagram user reelsReturns 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/reels2 crGET - List Instagram user storiesReturns the stories currently live on a public Instagram profile, identified by username_or_id.
/v2/instagram/user/stories2 crGET - List similar Instagram usersReturns 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/similar2 crGET
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/v2/instagram/search/posts?keyword=<keyword>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.