Instagram Profile by numeric ID API

Read an Instagram account's current username and profile data from its numeric user_id: follower_count, following_count and post_count, for $0.56 per 1,000 calls.

  • user_id stays the same when the username changes
  • No recent_posts or highlight_count
  • A post result's author_id works as user_id

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": "profile_by_id",
      "params": {
        "user_id": "787132"
      }
    }
  2. 2JSON response

    {
      "results": {
        "username": "n•••o",
        "bio": "Step into wonder and find your inner explorer with National Geographic 🌎",
        "follower_count": 268002941,
        "following_count": 195,
        …
      }
    }
  3. 3Fields

    usernamebiofollower_countfollowing_count
    n•••oStep into wonder and find your inner explorer with National Geographic 🌎268002941195
  4. 4CSV

    instagram-profile_by_id-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,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

A request with the numeric user_id returns one JSON object with username, bio, follower_count and more, ready as a field table or a CSV.

What data you get

The table shows a real call for 787132, captured November 21, 2026 at 07:18 (UTC), that returned one object. Gray bars cover personal information that was removed (••• in the CSV). Your own calls return the fields listed in the field reference.

usernamedisplay_namebiofollower_countfollowing_countpost_countis_privateis_verifiedis_businessis_professionalcategoryexternal_urlavatar_urluser_idavatar_hd_urlexternal_urlshas_reelsurlreels_countbusiness_emailbusiness_phonethreads_usernamefbidis_memorializedis_joined_recentlyaccount_typeemailsphonespronounsbio_links_detailmessaging_idsbusiness_addressplatform
n•••oN•••cStep into wonder and find your inner explorer with National Geographic 🌎26800294119532196falsetruetruetruenullhttp://visitstore.bio/natgeo787132[{"url":"http://visitstore.bio/natgeo"},{"url":"https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002","title":"Subscribe Here!"}]truehttps://www.instagram.com/natgeo/1nullnulln•••onullnullbusinessnullnullnull[{"url":"http://visitstore.bio/natgeo","type":"external"},{"url":"https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002","title":"Subscribe Here!","type":"external"}]nullnullinstagram

Use cases

  • Find an account after a rename

    If you only hold an old user_id, read the account's current username with it, even after a username change.

  • Turn a post author into a username

    author_id in a post result is the user_id. Pass it in to get the author's current username and follower_count.

  • Track accounts by number

    Use user_id as the account key and read username and bio each time to log renames and bio changes.

  • Fill in contact details

    Read external_urls, bio_links_detail and business_email to complete an account's links and public contact details.

Instagram Graph API vs EveryInfra

Instagram's Graph API and EveryInfra profile_by_id, compared on the account ID, which accounts you can read and access.

ComparedInstagram Graph APIEveryInfra
Account IDField id: "App-scoped User ID."user_id is the account's numeric ID, such as 787132. It does not change when the username changes, and the call returns the account's current username.
Which accounts"Get fields and edges on an Instagram Business or Creator Account."The account that user_id names. The response includes the is_business, is_professional and account_type markers.
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

  • user_id is required: the account's numeric ID, such as 787132.
  • You get the ID from the user_id in a profile result or the author_id in a post result.
  • The fields match profile, but recent_posts and highlight_count are not included.
  • One call reads one account and returns one object.

Pricing

Each call costs $0.000556, whatever the number of fields, and reads one account. 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": "profile_by_id",
  "params": {
    "user_id": "787132"
  }
}'

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 profile_by_id, 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 Profile by numeric ID endpoint (instagram/profile_by_id).

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 profile_by_id, and put the parameters inside params.
- Required parameters:
  - user_id: The numeric Instagram user ID, such as 787132; it is the user_id in profile results and the author_id in post results.
- Returns one object. Main fields: 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); 32 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Example request body:
{
  "platform": "instagram",
  "action": "profile_by_id",
  "params": {
    "user_id": "787132"
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- 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.
actionbodystringYesprofile_by_idCapability identifier, fixed value.
user_idbody.paramsstringYes-The numeric Instagram user ID, such as 787132; it is the user_id in profile results and the author_id in post results.

Response example

#
Captured November 21, 2026 at 07:18 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "instagram",  "action": "profile_by_id",  "results": {    "username": "n•••o",    "display_name": "N•••c",    "bio": "Step into wonder and find your inner explorer with National Geographic 🌎",    "follower_count": 268002941,    "following_count": 195,    "post_count": 32196,    "is_private": false,    "is_verified": true,    "is_business": true,    "is_professional": true,    "external_url": "http://visitstore.bio/natgeo",    "avatar_url": "https://scontent-fra5-1.cdninstagram.com/•••",    "user_id": "787132",    "avatar_hd_url": "https://scontent-fra5-1.cdninstagram.com/•••",    "external_urls": [      {        "url": "http://visitstore.bio/natgeo"      },      {        "url": "https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002",        "title": "Subscribe Here!"      }    ],    "has_reels": true,    "url": "https://www.instagram.com/natgeo/",    "reels_count": 1,    "threads_username": "n•••o",    "fbid": "•••",    "account_type": "business",    "bio_links_detail": [      {        "url": "http://visitstore.bio/natgeo",        "type": "external"      },      {        "url": "https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002",        "title": "Subscribe Here!",        "type": "external"      }    ],    "platform": "instagram"  },  "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.
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).

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

Which fields does the account-by-ID endpoint return?

One object: username, display_name, bio, follower_count, following_count, post_count, is_private, is_verified, account_type, external_url, user_id and more.

Where do I get user_id?

From the user_id in a profile result or the author_id in a post result. Both are this ID.

How much does it cost to look up one account by ID?

Billing is per call: $0.000556 each, or $0.56 per 1,000 calls, whatever the number of fields. Failed calls and empty results are not charged.

Do I need to log in to Instagram to look up an account by ID?

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

How do profile_by_id and profile differ?

The input differs: profile_by_id takes the numeric user_id; profile takes username. The profile_by_id result has no recent_posts or highlight_count.

The same EveryInfra API key also calls Instagram's other endpoints, such as profile, which reads a profile from username.

Google Analytics needs consent. Privacy