MarkdownCopies this page as Markdown, ready to paste into an AI assistant.
Instagram API
32 Instagram endpoints behind one key, priced in credits per call or per result and routed to the cheapest healthy source.
On this page
Social · 32 endpoints · from 1 credit per call
Endpoints
- POSTInstagram Basic Profile
/v1/run/instagram.basic_profileCore public profile fields (username, counts, bio, verification) for an Instagram account when you already hold its numeric user id.1 creditper call - POSTInstagram Comment Replies
/v1/run/instagram.comment_repliesReplies to one comment on a public Instagram post or reel, paged by cursor, with text, author and like counts.1 creditper call - POSTInstagram Hashtag Recent Posts
/v1/run/instagram.hashtag_recent_postsNewest Instagram posts under a hashtag, read from its live chronological feed, for monitoring a tag as posts appear.1 creditper call - POSTInstagram Highlight Detail
/v1/run/instagram.highlight_detailEvery story item of one Instagram highlight by id: photo and video URLs, sizes, durations and timestamps.1 creditper call - POSTInstagram Media Transcript
/v1/run/instagram.media_transcriptSpoken-audio transcript of a public Instagram reel or video post by URL, one entry per video in the post.3 creditsper call - POSTInstagram Post
/v1/run/instagram.postOne public Instagram post or reel by URL: owner, caption, like, comment and play counts, media URLs and audio.1 creditper call - POSTInstagram Post Comments
/v1/run/instagram.post_commentsComments on a public Instagram post or reel by URL, one page per call, with text, author, likes and reply counts.1 creditper call - POSTInstagram Profile
/v1/run/instagram.profilePublic profile of one Instagram account by handle: bio and links, follower, following and post counts, verification and business flags.1 creditper call - POSTInstagram Profile Contact Info
/v1/run/instagram.profile_contactContact email and phone number an Instagram creator or business publishes on its profile, including the address behind the Email and Call buttons.1 creditper call - POSTInstagram Profile Search
/v1/run/instagram.search_profilesFind public Instagram profiles matching a keyword (name, handle or bio words) with handle, name, verified and private flags.1 creditper call - POSTInstagram Reel Transcript
/v1/run/instagram.reel_transcriptSpeech transcript of a public Instagram reel or video post with timed segments, billed per started audio minute.4.38 creditsper result - POSTInstagram Reels Search
/v1/run/instagram.reels_searchSearch Instagram Reels by keyword through Instagram's own reels search, with views, likes, comments, caption and creator.1 creditper call - POSTInstagram Reels Web Search
/v1/run/instagram.web_reels_searchSearch Instagram Reels through a web search index with an optional recency window and numbered pages (pages 1-11 of about 10 reels).1 creditper call - POSTInstagram Search
/v1/run/instagram.searchKeyword search over Instagram users, hashtags or places with names, counts and links.1 creditper call - POSTInstagram Similar Profiles
/v1/run/instagram.similar_profilesAccounts Instagram recommends as similar to a public profile, with handle, display name, verified flag and avatar.1 creditper call - POSTInstagram Stories (basic)
/v1/run/instagram.stories_thinLightweight list of a public account's live stories: media URL, permalink, owner and posting time only.3 creditsper call - POSTInstagram Stories (full)
/v1/run/instagram.stories_fullCurrently live stories of a public Instagram account with media URLs, type, dimensions, posting time and 24-hour expiry.3 creditsper call - POSTInstagram Tagged Posts
/v1/run/instagram.tagged_postsPosts in which a public Instagram account is tagged, newest first, with the posting author, caption and engagement counts.1 creditper call - POSTInstagram User Highlights
/v1/run/instagram.user_highlightsStory highlight reels of a public Instagram account by handle: ids, titles, cover images and owner.3 creditsper call - POSTInstagram User Posts
/v1/run/instagram.user_postsRecent feed posts of a public Instagram account by handle (about 12 per page) with caption, likes, comments, views, media and cursor pagination.1 creditper call - POSTInstagram User Reels
/v1/run/instagram.user_reelsReels of a public Instagram account by handle or user id with plays, likes, comments and caption, with cursor pagination.1 creditper call - POSTInstagram Hashtag AnalyticsPlanned
/v1/run/instagram.hashtag_analyticsTotal public post count for an Instagram hashtag, plus related tags when the source returns them.Planned - POSTInstagram Hashtag SearchPlanned
/v1/run/instagram.search_hashtagPosts under a hashtag from a web search index, filterable by date window and media type.Planned - POSTInstagram Location PostsPlanned
/v1/run/instagram.location_postsPublic posts tagged at an Instagram location id, ranked or most recent, with cursor pagination.Planned - POSTInstagram Location SearchPlanned
/v1/run/instagram.search_locationsSearch Instagram places by keyword and return each place id, name, address and coordinates.Planned - POSTInstagram Profile EmbedPlanned
/v1/run/instagram.embedPublic embed HTML document for an Instagram profile handle.Planned - POSTInstagram Profile Search with ContactPlanned
/v1/run/instagram.search_profiles_contactKeyword profile search that also returns each hit's country, join month, public email and phone, billed per profile returned.Planned - POSTInstagram Reels by AudioPlanned
/v1/run/instagram.audio_reelsReels that use a given Instagram audio track, by audio id.Planned - POSTInstagram Search FollowersPlanned
/v1/run/instagram.search_followersSearch within a public account's followers by name or username using Instagram's own follower search.Planned - POSTInstagram Search FollowingPlanned
/v1/run/instagram.search_followingSearch within the accounts a public user follows by name or username using Instagram search.Planned - POSTInstagram Trending ReelsPlanned
/v1/run/instagram.trending_reelsRecently popular Instagram reels, up to 12 per call, with caption, creator and engagement counts.Planned - POSTInstagram User RepostsPlanned
/v1/run/instagram.user_repostsPosts a public Instagram account has reposted to its feed, by numeric user id, with cursor pagination.Planned
Calling them
Every endpoint on this page is one POST to https://api.primaryapi.com/v1/run/{sku} with your API key and a JSON body. Responses share one envelope, so code written for one endpoint handles the others. For example, instagram.basic_profile:
curl -sS -X POST "https://api.primaryapi.com/v1/run/instagram.basic_profile" \
-H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"userId":"25025320"}'const res = await fetch('https://api.primaryapi.com/v1/run/instagram.basic_profile', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PRIMARYAPI_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
userId: '25025320',
}),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.code}: ${body.error}`);
// found:false is a successful answer ("does not exist"), not an error
console.log(body.output.found ? body.output.data : body.output.reason, body.credits);import os
import requests
res = requests.post(
"https://api.primaryapi.com/v1/run/instagram.basic_profile",
headers={"Authorization": f"Bearer {os.environ['PRIMARYAPI_API_KEY']}"},
json={
"userId": "25025320",
},
timeout=60,
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['code']}: {body['error']}")
# found=False is a successful answer ("does not exist"), not an error
print(body["output"]["data"] if body["output"]["found"] else body["output"]["reason"], body["credits"])New to PrimaryAPI? Start with the Quickstart, then read Making requests.