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 Use | 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 Use Instagram | 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 Within Instagram, | 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 Use Instagram | 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 Instagram | 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 Use Instagram | 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 Read reels from Instagram by setting action to | 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 Use | 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 Use Instagram account input with | username | usernames | Sync delivery | — | $0.56 per 1,000 requests | id · username · url · name · avatar_url · follower_count · following_count · platform |
followers_listFollower list Read exposed follower records from Instagram by setting action to | 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 Treat | 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?
Use post to retrieve one public Instagram post. Pass the target through urls. For Instagram post, supply content_type, url, and urls; results include url, view_count, media_type, like_count, comment_count, author_username, posted_at, post_id, text, location, and author_name.
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?
Use Instagram profile to read one Instagram public record. Use Instagram account input with profile; Instagram then reads public record. Profile detail reads public identity, biography, and audience metadata. Pass username to Instagram profile; returned objects expose username, bio, following_count, is_private, category, is_verified, external_url, is_business, is_professional, post_count, avatar_url, display_name, and follower_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 persona parameters mean?
Within Instagram, persona addresses account insights. Use Instagram account input with persona; Instagram then reads account insights. Persona keeps account-level insights separate from posts and relationship lists. For Instagram persona, supply username; results include display_name, is_professional, category, following_count, is_verified, avatar_url, post_count, external_url, bio, username, follower_count, is_private, and is_business.
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?
Use Instagram user_posts to read public Instagram account posts. Use Instagram account input with user_posts; Instagram then reads account posts. Pass username to Instagram user_posts; returned objects expose location, view_count, author_name, posted_at, media_type, author_username, like_count, comment_count, post_id, url, and text.
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 Instagram discover with keyword for Instagram discovery results. Instagram discover keeps Instagram field meanings action-specific. Call Instagram discover with results_type and keyword; Instagram discover exposes post_id, text, url, like_count, posted_at, author_username, author_name, media_type, view_count, location, and comment_count.
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?
Use Instagram comments to read visible Instagram comments. Use Instagram comments with url; Instagram then selects object comments. For Instagram comments, supply url; results include text, posted_at, author_username, platform, post_url, url, is_verified, id, like_count, reply_count, and author_name.
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?
Read reels from Instagram by setting action to reels. Use Instagram account input with reels; Instagram then reads reels. Instagram reels takes url and username and yields play_count, title, transcript, duration_sec, and artist.
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?
Use hashtag to retrieve an Instagram hashtag feed. Pass the tag in the documented format. For Instagram hashtag, supply hashtag, keyword, results_type, and tag; results include url, view_count, like_count, author_username, posted_at, text, comment_count, post_id, location, author_name, and media_type.
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?
Use Instagram account input with followers; Instagram then reads the exposed follower measure. Pass usernames and username to Instagram followers; returned objects expose follower_count, name, url, id, username, platform, following_count, and avatar_url.
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?
Read exposed follower records from Instagram by setting action to followers_list. Use Instagram account input with followers_list; Instagram then reads exposed follower records. Instagram followers_list takes username and yields url, avatar_url, is_verified, platform, relation, of_user, id, is_private, name, and username.
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?
Treat following_list as the Instagram view for exposed following records. Use Instagram account input with following_list; Instagram then reads exposed following records. For Instagram following_list, supply username; results include id, is_private, avatar_url, relation, url, platform, is_verified, username, of_user, and name.
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.