↑ ↓ to move ↵ to open

Instagram API reference

Get public Instagram profiles, posts, reels, comments and hashtag results as clean JSON. Send a username, a post link or a keyword. No Instagram login and no cookies.

At a glance

Platform ID
instagram
Endpoints
19
Price
From 0.75 credits per call; failed calls are free
Pin in MCP
https://data.upscrape.com/mcp?platforms=instagram
Pin tools
OpenAPI
openapi.json
Download

The Instagram API has 19 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Instagram in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.

The inputs you send most are url, hashtag and query. Prices run from 0.75 credits to 5–25 credits per call, and a failed call costs nothing.

Endpoints

Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.

EndpointWhat it returnsPrice
instagram.profile.get Get a public profile from its username or URL: name, bio, links, follower and post counts, verified and business status, and its latest posts. 1–1.5 credits
instagram.profile-posts.list List a public profile's posts, newest first, with caption, likes, comments and post time. 3–10 credits
instagram.reels.list List a public profile's reels with caption, likes, comments and post time, page by page. 3–10 credits
instagram.post.get Get one post, reel or carousel from its link or shortcode: author, caption, media and the engagement counts Instagram shows. 0.75 credits
instagram.comments.list Read the public comments shown on a post or reel, page by page. 0.75–25 credits
instagram.hashtag-posts.search Find posts and reels for a hashtag, filtered by posts or reels and by how recent they are. 4–25 credits
instagram.hashtag.search See the popular content Instagram shows for a hashtag keyword, with post dates and engagement counts. 5–25 credits
instagram.popular.search Search popular Instagram content by keyword, with post dates, likes, comments and plays. 5–25 credits
instagram.topic.search Get the popular content for an Instagram topic, by topic name, ID or link. 5–25 credits
instagram.topics.list See the topics Instagram's Explore shows right now, grouped by section, with how many posts each has. 0.75 credits
instagram.profile.search Find public profiles that match a search, with an option to add each profile's details. 1–25 credits
instagram.reels.search Find public reels that match a search, with an option to add each reel's details. 1–10 credits
instagram.explore.list Read the sections of Instagram's public Explore page, or page through one section. 0.75–1 credits
instagram.audio-reels.list List the public reels that use one audio track, from its audio ID. 2–10 credits
instagram.highlights.list List a public profile's story highlights: each collection's title and ID. 1 credit
instagram.highlights.items.get Get the saved stories inside one highlight collection, from the profile and collection ID. 1.5 credits
instagram.profile.basic Get a public profile's basic details from its numeric user ID. 0.75 credits
instagram.location.get Get a public Instagram location from its ID: name, category, coordinates and how many posts are tagged there. 1 credit
instagram.embed.get Get the ready-made embed code Instagram offers for a public profile or post, with or without the caption. 0.75 credits

What to know

  • Public accounts only Every call reads what Instagram shows to any visitor. Private accounts and anything behind a login are not part of it.
  • Counts as Instagram shows them Followers, likes and comments are Instagram's own numbers at the moment of the call. Some accounts hide like counts.
  • Comments are a preview Instagram shows a selection of comments to visitors. The comments endpoint returns those and says when more were not shown.
  • Search follows Instagram's ranking Hashtag, keyword and topic results are the popular content Instagram picks, not a full list of every post.
  • Next pages List endpoints return next_cursor or next_page. Send it back with the same input to continue.

Something missing or unclear? Ask the team that builds the Instagram endpoints.