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_idstays the same when the username changes- No
recent_postsorhighlight_count - A post result's
author_idworks asuser_id
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "instagram", "action": "profile_by_id", "params": { "user_id": "787132" } }2JSON response
{ "results": { "username": "n•••o", "bio": "Step into wonder and find your inner explorer with National Geographic 🌎", "follower_count": 268002941, "following_count": 195, … } }3Fields
username bio follower_count following_count n•••o Step into wonder and find your inner explorer with National Geographic 🌎 268002941 195 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
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.
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| n•••o | N•••c | Step into wonder and find your inner explorer with National Geographic 🌎 | 268002941 | 195 | 32196 | false | true | true | true | null | http://visitstore.bio/natgeo | 787132 | [{"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!"}] | true | https://www.instagram.com/natgeo/ | 1 | null | null | n•••o | null | null | business | null | null | null | [{"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"}] | null | null |
Use cases
Find an account after a rename
If you only hold an old
user_id, read the account's currentusernamewith it, even after a username change.Turn a post author into a username
author_idin a post result is theuser_id. Pass it in to get the author's currentusernameandfollower_count.Track accounts by number
Use
user_idas the account key and readusernameandbioeach time to log renames and bio changes.Fill in contact details
Read
external_urls,bio_links_detailandbusiness_emailto 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.
| Compared | Instagram Graph API | EveryInfra |
|---|---|---|
| Account ID | Field 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 need | Access 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_idis required: the account's numeric ID, such as 787132.- You get the ID from the
user_idin aprofileresult or theauthor_idin a post result. - The fields match
profile, butrecent_postsandhighlight_countare 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.
| Calls | Cost |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
Totals use the list price per call.
Code samples
#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.
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
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | instagram | Platform identifier, fixed value. |
action | body | string | Yes | profile_by_id | Capability identifier, fixed value. |
user_id | body.params | string | Yes | - | 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
#{ "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.
| Field | Meaning |
|---|---|
username | Username (@handle). |
display_name | Display name; can differ from username. |
bio | Profile bio written by the account; may contain line breaks and emoji. |
follower_count | Followers. null means not disclosed, not 0. |
following_count | Accounts followed. null means not disclosed, not 0. |
post_count | Total posts. null means not disclosed, not 0. |
is_private | Whether the account is private. |
is_verified | Whether the platform verified the account. null means it cannot be determined. |
is_business | Whether the account is a business account. |
is_professional | Whether the account is a professional account (business or creator). |
category | Category name in the platform's own taxonomy, not normalized across platforms. |
external_url | External link on the profile. |
avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
user_id | User's unique ID on the platform. |
avatar_hd_url | High-resolution avatar URL (avatar_url is the small image). |
external_urls | All external links in the bio: url, title (external_url is only the first one). |
has_reels | Whether the account has posted Reels. |
url | Link to the record on the platform. |
reels_count | Number 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_username | Name shown on the Threads badge on the profile; usually the person's Threads username. |
fbid | Another 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_type | Account 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_detail | Each 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. |
platform | Source 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.
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.
Related Instagram endpoints
The same EveryInfra API key also calls Instagram's other endpoints, such as profile, which reads a profile from username.
- Post details
post$0.56 per 1,000 callsFetch one or more Instagram posts or Reels from the links inurls. - Details
profile$0.56 per 1,000 callsLook up an Instagram account by handle or profile URL. - Account insights
persona$0.56 per 1,000 callsGet an account overview for an Instagram handle, built from its public profile. - Posts by user
user_posts$0.56 per 1,000 callsList posts from an Instagram account byusername, each with caption, media type, likes, comments, views, location, hashtags and top comments. - Content discovery
discover$0.56 per 1,000 callsTrack posts under an Instagram hashtag passed inkeyword. - Comments
comments$0.79 per 1,000 callsRead comments on one Instagram post or Reel aturl. - Reels
reels$1.19 per 1,000 callsPull an Instagram account's Reels byusername, with caption, play count, duration in seconds, likes, comments, hashtags, music and video link. - Hashtag
hashtag$0.56 per 1,000 callsCollect posts for an Instagram hashtag inhashtag, without the # sign. - Followers
followers$0.56 per 1,000 callsSee the follower and following counts of an Instagram account byusername. - Follower list
followers_list$0.56 per 1,000 callsList the accounts that follow an Instagram user, byusername, with handle, name, avatar, private and verified flags and relation type. - Following list
following_list$0.56 per 1,000 callsList the accounts an Instagram user follows, byusername, with handle, name, avatar, private and verified flags and relation type. - Account search
user_search$4.81 per 1,000 callsSearch Instagram accounts bykeyword, in the order Instagram search ranks them for that word. - Reels search
reels_search$7.19 per 1,000 callsSearch Instagram Reels bykeyword, such as coffee. - Similar accounts
similar_profiles$8.81 per 1,000 callsFind accounts Instagram suggests as similar to one account, byusernamesuch as nasa. - Tagged posts
tagged_posts$7.44 per 1,000 callsList public posts by other accounts that tag one Instagram account, given asusername, profile URL or numeric user ID. - Stories
stories$1.5 per 1,000 callsGet the stories an Instagram account has live right now, from its username. - Story highlights
highlights$1.6 per 1,000 callsList the story highlights on an Instagram profile. - Comment replies
comment_replies$0.88 per 1,000 callsRead the replies under one comment on an Instagram post or Reel, from the post link and the comment'sidreturned bycomments. - Post likers
likers$1.32 per 1,000 callsList the accounts that liked one Instagram post or Reel, from itsurl. - Posts at a location
location_posts$0.56 per 1,000 callsList the posts tagged at one Instagram location, fromlocation_id(theidin a post'slocation_detail, or a location page link). - Reels using a music track
audio_posts$0.56 per 1,000 callsList the Instagram Reels that use one piece of music, fromaudio_id(theaudio_idin a post'smusic, or an audio page link). - Explore
explore$0.56 per 1,000 callsRead one page of the posts Instagram recommends on Explore; no input is needed. - Engagement statistics
engagement$0.56 per 1,000 callsWork out an Instagram account's engagement from its latest posts, byusername. - About this account
user_about$0.56 per 1,000 callsRead the About this account panel of an Instagram profile byusername: the month it joined (joined_at), itscountry, how many times it changed its username (former_usernames_count) and when it was verified. - Location details
location_info$0.56 per 1,000 callsRead one Instagram location from itslocation_id: name, category, coordinates (lat,lng), address details when listed, andpost_count. - Link recognition
resolve_links$0.56 per 1,000 callsConvert one Instagram post reference intext(a post link, a shortcode or a numeric post ID) into all three:shortcode,media_idandurl. - Post embed code
oembed$0.56 per 1,000 callsGet the oEmbed data and embed code for one Instagram post or Reel from itsurl: the same fields as Instagram's official oEmbed, withhtmlready to paste into a web page. - Post caption translation
post_translation$6.39 per 1,000 callsTranslate the caption of one Instagram post intotarget_language(defaulten), from itsurlormedia_id. - Nearby locations
location_nearby$0.56 per 1,000 callsList the locations Instagram shows near one location, from itslocation_id: about 20 rows in one call, no next page. - Hashtag search
hashtag_search$0.56 per 1,000 callsFind Instagram hashtags for akeyword: the hashtags Instagram's search box suggests, withpost_countfor each. - Stories in a highlight
highlight_stories$0.56 per 1,000 callsRead every story in one Instagram highlight fromhighlight_id(theidfromhighlights, or a highlight link): up to 100 stories in one call, with media links,posted_atandduration_seconds. - Comment translations
comment_translations$6.39 per 1,000 callsTranslate up to 10 comments on one Instagram post, from the posturlandcomment_ids, intotarget_language(defaulten). - Recommended Reels
recommended_reels$1.18 per 1,000 callsRead the Reels Instagram recommends on its Reels page, 10 per page; no input is needed. - User reposts
user_reposts$0.56 per 1,000 callsList the posts and Reels an Instagram account reposted to its profile, byusername, 12 per page. - Cities in a country
location_cities$0.56 per 1,000 callsList the cities Instagram's location directory has for onecountry_code, 96 per page. - Locations in a city
city_locations$0.56 per 1,000 callsList the locations Instagram's location directory has for one city, fromcity_id, 96 per page. - Profiles in bulk
profiles_batch$0.56 per 1,000 callsLook up as many as 20 Instagram accounts at once fromusernames, each given as a username such asnatgeoor a profile link.