Instagram Profiles in bulk API

Look up several Instagram accounts at once with usernames: each row has username, bio, follower_count and input, for $0.56 per 1,000 calls.

  • Each account in usernames counts as one call
  • input ties each row to the item you sent
  • Accounts not found are listed in missed

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "profiles_batch",
      "params": {
        "usernames": [
          "natgeo",
          "nasa"
        ]
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "username": string,
          "display_name": string,
          "bio": string,
          "follower_count": number
        },
        …
      ]
    }
  3. 3Rows

    usernamedisplay_namebiofollower_count
    stringstringstringnumber
  4. 4CSV

    instagram-profiles_batch-sample.csv username,display_name,bio,follower_count,following_count,post_count,is_private,is_verified,is_business,is_professional,category,external_url,avatar_url,user_id,avatar_hd_url,external_urls,has_reels,highlight_count,recent_posts,url,reels_count,business_email,business_phone,threads_username,fbid,is_memorialized,is_joined_recently,account_type,emails,phones,pronouns,bio_links_detail,messaging_ids,business_address,platform,input

A request with a usernames array returns one profile row per account, and input ties each row to the item you sent. Accounts that were not found are listed in missed in the response. Rows come as a field table or a CSV.

What data you get

Each row is one account. The table lists the fields each row returns, with their types and meanings, and shows no values.

FieldTypeMeaning
usernamestringUsername (@handle).
display_namestringDisplay name; can differ from username.
biostringProfile bio written by the account; may contain line breaks and emoji.
follower_countnumberFollowers. null means not disclosed, not 0.
following_countnumberAccounts followed. null means not disclosed, not 0.
post_countnumberTotal posts. null means not disclosed, not 0.
is_privatebooleanWhether the account is private.
is_verifiedbooleanWhether the platform verified the account. null means it cannot be determined.
is_businessbooleanWhether the account is a business account.
is_professionalbooleanWhether the account is a professional account (business or creator).
categorystringCategory name in the platform's own taxonomy, not normalized across platforms.
external_urlstringExternal link on the profile.
avatar_urlstringAvatar image link. Some platforms return sized CDN links that can expire.
user_idstringUser's unique ID on the platform.
avatar_hd_urlstringHigh-resolution avatar URL (avatar_url is the small image).
external_urlsarrayAll external links in the bio: url, title (external_url is only the first one).
has_reelsbooleanWhether the account has posted Reels.
highlight_countnumberNumber of Highlights.
recent_postsarrayLatest posts on the profile page (pinned posts included), as an array; each entry is one post with the same fields as a row of user_posts (a field appears only when it has a value). Absent when the account is private or has no posts.
urlstringLink to the record on the platform.
reels_countnumberNumber of Reels the account has posted (integer).
business_email—Email the business account makes public behind the Contact button on its profile. Absent when there is none.
business_phone—Phone number the business account makes public behind the Contact button on its profile. Absent when there is none.
threads_usernamestringName shown on the Threads badge on the profile; usually the person's Threads username.
fbidstringAnother numeric ID that Meta assigns to the account; it is not the same number as user_id.
is_memorialized—The account is memorialized (the status Instagram gives an account after its owner has died). Appears only for memorialized accounts, with the value true.
is_joined_recently—The profile is marked "Joined recently". Appears only when the mark is there, with the value true.
account_typestringAccount type: personal (individual), business or creator.
emails—Contact email addresses (a record can have several), passed through as is with duplicates removed.
phones—Phone numbers the person wrote publicly in the bio, as an array. Only numbers that start with + or 00, or that follow a label such as WhatsApp or Phone, are included. Absent when there are none.
pronouns—Pronouns filled in on the profile, as an array.
bio_links_detailarrayEach link in the bio section, one entry per link: url (the real address, with the redirect layer Instagram wraps around it removed), title (link title, present only on some links), type (link type given by Instagram, such as external). external_urls holds the url and title of the same links.
messaging_ids—Chat accounts written publicly in the bio, one entry per account as {app, id}; app is a value such as wechat, line, telegram, kakao, skype or signal.
business_address—Address the business account makes public, as an object: street, city, zip, lat, lng; each appears only when available.
platformstringSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
input—(profiles_batch) The entry from usernames that this row answers, returned exactly as you passed it. Use it to match rows to your entries; the returned username can be written differently, for example when you passed a profile link.

Use cases

  • Look up a list in one request

    Put the accounts from a list in usernames and get back their follower_count and post_count in one request.

  • Match rows to your list with `input`

    input is the item you sent, returned as you wrote it. It matches rows back to your list even when you mix usernames and profile links.

  • Find accounts that were not found

    Read missed in the response to see which accounts were not found. They are not charged.

  • Sort private and business accounts

    Group by is_private, is_business and category to sort the accounts in your list.

Instagram Graph API vs EveryInfra

Instagram's Graph API and EveryInfra profiles_batch, compared on which accounts you can read and access.

ComparedInstagram Graph APIEveryInfra
Which accounts"Get fields and edges on an Instagram Business or Creator Account."Each account in usernames, as a username or a profile link. Each row includes the is_private, is_business and is_professional flags.
Access you needAccess token: "Required. App user’s User access token."One EveryInfra API key in the Authorization: Bearer header. No Instagram login or Instagram access token is needed.

Quotes are from Meta's developer documentation (the IG User page), checked 2026-11-22. Official sources: IG User (updated 2026-04-22)

Limits and gotchas

  • usernames is an array, not a comma-separated string. The maximum number of items is in the parameter reference.
  • Each item is a username or a profile link. An account can appear only once, and different letter case counts as the same account.
  • Billing is per account. Accounts that were not found are not charged and are listed in missed in the response.
  • The input on each row is the item you sent. The returned username can differ from what you wrote, for example when you sent a profile link.
  • For a private account, is_private is true and recent_posts is absent.
  • Only synchronous calls are supported.

Pricing

Billing is per account: each account in usernames counts as one call at $0.000556. Accounts that were not found are not charged and are listed in missed. Failed calls and empty results are not charged.

CallsCost
10,000$5.56
100,000$55.56
1,000,000$555.56

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "profiles_batch",
  "params": {
    "usernames": [
      "natgeo",
      "nasa"
    ]
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for profiles_batch, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Instagram Profiles in bulk endpoint (instagram/profiles_batch).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to instagram and action to profiles_batch, and put the parameters inside params.
- Required parameters:
  - usernames: Instagram accounts for profiles_batch, as an array of up to 20 entries; a comma-separated string is not accepted. Each entry is a username such as natgeo (a leading @ is dropped) or a profile link.
- Optional parameters:
  - limit: The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.
- Returns a list of records. Main fields of each record: username, display_name, bio, follower_count, following_count, post_count, is_private (Whether the account is private), is_verified, is_business (Whether the account is a business accou…), is_professional (Whether the account is a professional a…), category, external_url (External link on the profile); 35 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Example request body:
{
  "platform": "instagram",
  "action": "profiles_batch",
  "params": {
    "usernames": [
      "natgeo",
      "nasa"
    ]
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- This endpoint runs synchronously only; do not add "mode": "async" to the body.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesinstagramPlatform identifier, fixed value.
actionbodystringYesprofiles_batchCapability identifier, fixed value.
usernamesbody.paramsarrayYes-Instagram accounts for profiles_batch, as an array of up to 20 entries; a comma-separated string is not accepted. Each entry is a username such as natgeo (a leading @ is dropped) or a profile link. List each account once; a different capitalization is still the same account. A request with an unrecognized entry, a duplicate or more than 20 entries is rejected with a 422 before any charge. Billed per account; accounts not found are not charged and are listed in missed.
limitbody.paramsinteger (1–)No-The most rows to return in this call, an integer of 1 or more. The default applies when you leave it out, and a call can return fewer rows.

Response example

#
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
json
{  "id": "req_…",  "platform": "instagram",  "action": "profiles_batch",  "results": [    {      "username": …,      "display_name": …,      "bio": …,      "follower_count": …,      "following_count": …,      "post_count": …,      "is_private": …,      "is_verified": …,      "is_business": …,      "is_professional": …,      "category": …,      "external_url": …,      "avatar_url": …,      "user_id": …,      "avatar_hd_url": …,      "external_urls": …,      "has_reels": …,      "highlight_count": …,      "recent_posts": …,      "url": …,      "reels_count": …,      "business_email": …,      "business_phone": …,      "threads_username": …,      "fbid": …,      "is_memorialized": …,      "is_joined_recently": …,      "account_type": …,      "emails": …,      "phones": …,      "pronouns": …,      "bio_links_detail": …,      "messaging_ids": …,      "business_address": …,      "platform": …,      "input": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
usernameUsername (@handle).
display_nameDisplay name; can differ from username.
bioProfile bio written by the account; may contain line breaks and emoji.
follower_countFollowers. null means not disclosed, not 0.
following_countAccounts followed. null means not disclosed, not 0.
post_countTotal posts. null means not disclosed, not 0.
is_privateWhether the account is private.
is_verifiedWhether the platform verified the account. null means it cannot be determined.
is_businessWhether the account is a business account.
is_professionalWhether the account is a professional account (business or creator).
categoryCategory name in the platform's own taxonomy, not normalized across platforms.
external_urlExternal link on the profile.
avatar_urlAvatar image link. Some platforms return sized CDN links that can expire.
user_idUser's unique ID on the platform.
avatar_hd_urlHigh-resolution avatar URL (avatar_url is the small image).
external_urlsAll external links in the bio: url, title (external_url is only the first one).
has_reelsWhether the account has posted Reels.
highlight_countNumber of Highlights.
recent_postsLatest posts on the profile page (pinned posts included), as an array; each entry is one post with the same fields as a row of user_posts (a field appears only when it has a value). Absent when the account is private or has no posts.
urlLink to the record on the platform.
reels_countNumber of Reels the account has posted (integer).
business_emailEmail the business account makes public behind the Contact button on its profile. Absent when there is none.
business_phonePhone number the business account makes public behind the Contact button on its profile. Absent when there is none.
threads_usernameName shown on the Threads badge on the profile; usually the person's Threads username.
fbidAnother numeric ID that Meta assigns to the account; it is not the same number as user_id.
is_memorializedThe account is memorialized (the status Instagram gives an account after its owner has died). Appears only for memorialized accounts, with the value true.
is_joined_recentlyThe profile is marked "Joined recently". Appears only when the mark is there, with the value true.
account_typeAccount type: personal (individual), business or creator.
emailsContact email addresses (a record can have several), passed through as is with duplicates removed.
phonesPhone numbers the person wrote publicly in the bio, as an array. Only numbers that start with + or 00, or that follow a label such as WhatsApp or Phone, are included. Absent when there are none.
pronounsPronouns filled in on the profile, as an array.
bio_links_detailEach link in the bio section, one entry per link: url (the real address, with the redirect layer Instagram wraps around it removed), title (link title, present only on some links), type (link type given by Instagram, such as external). external_urls holds the url and title of the same links.
messaging_idsChat accounts written publicly in the bio, one entry per account as {app, id}; app is a value such as wechat, line, telegram, kakao, skype or signal.
business_addressAddress the business account makes public, as an object: street, city, zip, lat, lng; each appears only when available.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
input(profiles_batch) The entry from usernames that this row answers, returned exactly as you passed it. Use it to match rows to your entries; the returned username can be written differently, for example when you passed a profile link.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Instagram batch profiles endpoint return?

One row per account: username, display_name, bio, follower_count, following_count, post_count, is_private, is_verified, category, external_url, input and more.

How is a batch lookup billed?

Each account in usernames counts as one call: $0.000556 each, or $0.56 per 1,000 calls. Accounts that were not found are not charged. Failed calls and empty results are not charged.

How do I see which accounts were not found?

Read missed in the response. The accounts that were not found are listed there.

Do I need to log in to Instagram to look up accounts in a batch?

No. Put your EveryInfra API key in the Authorization: Bearer header. You need no Instagram login and no Instagram access token.

How do profiles_batch and profile differ?

profile reads one account from username. profiles_batch reads the accounts in usernames, and input on each row ties it to the item you sent.

The same EveryInfra API key also calls Instagram's other endpoints, such as profile, which reads one account.

Google Analytics needs consent. Privacy