EveryData platform API
Instagram API
The Instagram catalog exposes 11 action-specific paths for Instagram profiles, posts, Reels, hashtags, comments, follower counts, and relationship lists, beginning with `post`, `profile`, `persona` and preserving each object boundary.
The opening Instagram path, `post`, works with one public post using `urls`; `profile` instead works with the selected public record using `username`, preventing cross-action assumptions.
- Endpoint
- POST /api/v1/social
- Capabilities
- 11
- Per 1,000
- $0.556
Available capabilities
Compare the Instagram actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
postPost details Retrieve a public post from Instagram. Accepts these parameters: | urls | content_type, url | Sync delivery | Catalog values: defaultLimit=11, maxLimit=11. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location |
profileProfiles Retrieve public profile details from Instagram. Accepts these parameters: | username | — | Sync delivery | — | $0.56 per 1,000 requests | username · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url |
personaAccount insights Use the | username | — | Sync delivery | — | $0.56 per 1,000 requests | username · display_name · bio · follower_count · following_count · post_count · is_private · is_verified · is_business · is_professional · category · external_url · avatar_url |
user_postsPosts by user Retrieve public posts from Instagram. Accepts these parameters: | username | — | Async delivery | Catalog values: defaultLimit=30, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location |
discoverContent discovery Use the | keyword | results_type | Async delivery | Catalog values: defaultLimit=30, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location |
commentsComments Retrieve public comments from Instagram. Accepts these parameters: | url | — | Sync delivery | Catalog values: defaultLimit=50, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · text · url · like_count · reply_count · author_username · author_name · is_verified · posted_at · post_url · platform |
reelsReels Use the | username | url | Sync delivery | Catalog values: defaultLimit=30, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | artist · title · play_count · duration_sec · transcript |
hashtagHashtag Retrieve a public hashtag feed from Instagram. Accepts these parameters: | hashtag | keyword, results_type, tag | Sync delivery | Catalog values: defaultLimit=30, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | post_id · url · text · media_type · like_count · comment_count · view_count · author_username · author_name · posted_at · location |
followersFollowers Retrieve public follower metrics from Instagram. Accepts these parameters: | username | usernames | Sync delivery | — | $0.56 per 1,000 requests | id · username · url · name · avatar_url · follower_count · following_count · platform |
followers_listFollower list Retrieve accounts following the selected Instagram account. Accepts these parameters: | username | — | Sync delivery | Catalog values: defaultLimit=50, maxLimit=500. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform |
following_listFollowing list Retrieve accounts followed by the selected Instagram account. Accepts these parameters: | username | — | Sync delivery | Catalog values: defaultLimit=50, maxLimit=500. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | id · username · url · name · avatar_url · is_private · is_verified · relation · of_user · platform |
What does each Instagram action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Instagram post parameters mean?
Retrieve a public post from Instagram. Accepts these parameters: content_type, url, and urls. Returns these fields: view_count, media_type, like_count, and comment_count.
urlsRequired- Accepts an array of full Instagram post or Reel URLs (e.g., /p/<shortcode>/ or /reel/<shortcode>/) for the post action, billed per target URL. Unlike post, the comments action processes only a single URL.Instagram: Public Posts and Embedding BoundariesInstagram specifies that content from private accounts cannot be embedded, and public accounts can also turn off embedding. Being shareable or embeddable does not grant additional data access permissions; input and available scope for this endpoint remain governed by the instructions above.Checked
content_typeOptional- Defines the target search entity for post action requests: hashtag, place, or profile. Because post locates specific publications via URLs, setting this value does not guarantee that the returned response switches to hashtag or place discovery data.Allowed values:
hashtagplaceprofile urlOptional- Specifies a single Instagram post or Reel URL for the comments action. Profile URLs are not supported. For the reels action, passing a URL does not replace the required username parameter.
What do the Instagram profile parameters mean?
Retrieve public profile details from Instagram. Accepts these parameters: username. Returns these fields: username, bio, following_count, and is_private.
usernameRequired- Identifies an Instagram account handle without the @ symbol or as a full profile URL. Used by profile, persona, user_posts, and reels to fetch account data. The followers action returns only total follower counts, whereas followers_list and following_list return account lists.
What do the Instagram persona parameters mean?
Use the persona action on Instagram. Accepts these parameters: username. Returns these fields: display_name, is_professional, category, and following_count.
usernameRequired- Identifies an Instagram account handle without the @ symbol or as a full profile URL. Used by profile, persona, user_posts, and reels to fetch account data. The followers action returns only total follower counts, whereas followers_list and following_list return account lists.
What do the Instagram user_posts parameters mean?
Retrieve public posts from Instagram. Accepts these parameters: username. Returns these fields: location, view_count, author_name, and posted_at.
usernameRequired- Identifies an Instagram account handle without the @ symbol or as a full profile URL. Used by profile, persona, user_posts, and reels to fetch account data. The followers action returns only total follower counts, whereas followers_list and following_list return account lists.
What do the Instagram discover parameters mean?
Use the discover action on Instagram. Accepts these parameters: results_type and keyword. Returns these fields: post_id, text, like_count, and posted_at.
keywordRequired- Specifies the target hashtag string for the discover action, automatically stripping leading # symbols. This parameter queries hashtags rather than executing general full-text searches, and differs from the tag parameter in the hashtag action.
results_typeOptional- Filters content type for discover and hashtag actions, accepting posts (default), reels, or reel. Unrecognized values fall back to posts. This parameter filters platform content types and does not alter the response file format.Allowed values:
reelreels
What do the Instagram comments parameters mean?
Retrieve public comments from Instagram. Accepts these parameters: url. Returns these fields: text, posted_at, author_username, and post_url.
urlRequired- Specifies a single Instagram post or Reel URL for the comments action. Profile URLs are not supported. For the reels action, passing a URL does not replace the required username parameter.
What do the Instagram reels parameters mean?
Use the reels action on Instagram. Accepts these parameters: url and username. Returns these fields: play_count, title, transcript, and duration_sec.
usernameRequired- Identifies an Instagram account handle without the @ symbol or as a full profile URL. Used by profile, persona, user_posts, and reels to fetch account data. The followers action returns only total follower counts, whereas followers_list and following_list return account lists.
urlOptional- Specifies a single Instagram post or Reel URL for the comments action. Profile URLs are not supported. For the reels action, passing a URL does not replace the required username parameter.
What do the Instagram hashtag parameters mean?
Retrieve a public hashtag feed from Instagram. Accepts these parameters: hashtag, keyword, results_type, and tag. Returns these fields: view_count, like_count, author_username, and posted_at.
hashtagRequired- Accepts an Instagram hashtag string without the leading # symbol (e.g., coffee) to list associated posts or reels. This parameter requires a hashtag name rather than an account handle.
keywordOptional- Specifies the target hashtag string for the discover action, automatically stripping leading # symbols. This parameter queries hashtags rather than executing general full-text searches, and differs from the tag parameter in the hashtag action.
results_typeOptional- Filters content type for discover and hashtag actions, accepting posts (default), reels, or reel. Unrecognized values fall back to posts. This parameter filters platform content types and does not alter the response file format.Allowed values:
reelreels tagOptional- Provides compatibility input for the hashtag action, automatically stripping leading # symbols. When both are supplied, hashtag takes precedence. Public requests must still include the required hashtag parameter.
What do the Instagram followers parameters mean?
Retrieve public follower metrics from Instagram. Accepts these parameters: usernames and username. Returns these fields: follower_count, name, username, and following_count.
usernameRequired- Identifies an Instagram account handle without the @ symbol or as a full profile URL. Used by profile, persona, user_posts, and reels to fetch account data. The followers action returns only total follower counts, whereas followers_list and following_list return account lists.
usernamesOptional- Accepts an array of Instagram account handles for the followers action, taking precedence over a single username. Requests are billed per target handle, must still include the required username parameter, and return follower counts rather than individual subscriber profiles.
What do the Instagram followers_list parameters mean?
Retrieve accounts following the selected Instagram account. Accepts these parameters: username. Returns these fields: avatar_url, is_verified, relation, and of_user.
usernameRequired- Identifies an Instagram account handle without the @ symbol or as a full profile URL. Used by profile, persona, user_posts, and reels to fetch account data. The followers action returns only total follower counts, whereas followers_list and following_list return account lists.
What do the Instagram following_list parameters mean?
Retrieve accounts followed by the selected Instagram account. Accepts these parameters: username. Returns these fields: is_private, avatar_url, relation, and is_verified.
usernameRequired- Identifies an Instagram account handle without the @ symbol or as a full profile URL. Used by profile, persona, user_posts, and reels to fetch account data. The followers action returns only total follower counts, whereas followers_list and following_list return account lists.
How to use the Instagram API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"instagram","action":"post","params":{"urls":"<urls>"}}'
Instagram API questions
What can I retrieve with the Instagram API?
Set platform to instagram. The current catalog lists post details, profiles, account insights, posts by user, content discovery, and more. These action names identify different Instagram objects or views; they are not interchangeable search modes.
Which input starts a Instagram `post` request?
Accepts an array of full Instagram post or Reel URLs (e.g., /p/<shortcode>/ or /reel/<shortcode>/) for the post action, billed per target URL. Unlike post, the comments action processes only a single URL. Send it as urls inside params.
Which fields can Instagram `post` return?
Its declared schema includes post_id, text, media_type, and like_count. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Instagram action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery and async delivery; poll a returned job ID only for an action labeled asynchronous.