# Instagram Profiles in bulk API (instagram.profiles_batch)

- Canonical page: [https://everyinfra.com/en/instagram-api/profiles_batch](https://everyinfra.com/en/instagram-api/profiles_batch?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "instagram", "action": "profiles_batch", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Billing unit: each element in `usernames` counts as one call; the number of elements you send sets the charge
- Returns: list
- Mode: sync only; everything it returns (every target of a batch, or every SKU of a product) is read in one call, and "mode": "async" returns 422 before any charge

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| usernames | not declared | yes | not declared | 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`. |
| limit | integer (1–) | no | not declared | 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 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. |
| highlight_count | Number of Highlights. |
| recent_posts | Latest 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. |
| 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). |
| 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. |

## 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": "profiles_batch",
  "params": {
    "usernames": [
      "natgeo",
      "nasa"
    ]
  }
}'
```

```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": "profiles_batch",
        "params": {
            "usernames": [
                "natgeo",
                "nasa",
            ],
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

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

## 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
