# Instagram Profile by numeric ID API (instagram.profile_by_id)

- Canonical page: [https://everyinfra.com/en/instagram-api/profile_by_id](https://everyinfra.com/en/instagram-api/profile_by_id?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "instagram", "action": "profile_by_id", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=instagram&action=profile_by_id

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| user_id | not declared | yes | not declared | The numeric Instagram user ID, such as `787132`; it is the `user_id` in `profile` results and the `author_id` in post results. |

## Response fields (items in `results`)

| 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). |

## Example

```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"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "instagram",
        "action": "profile_by_id",
        "params": {
            "user_id": "787132",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-11-21T07:18:47Z. `results` and `count` are real 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.

```text
{
  "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": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=instagram
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
