Threads Profiles in bulk API
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
Look up as many as 20 Threads accounts at once from usernames, each a username (a leading @ is fine) or a profile link. Each account found is one row with bio, followers, verified and private flags, avatar, bio links, topics and public view count, plus input, the entry you passed. Billed per account; accounts not found are not charged and come back in missed. An array with a duplicate, an unrecognized entry or more than 20 entries is rejected with a 422 before any charge.
Send POST https://api.everyinfra.com/api/v1/social with platform set to threads and action set to profiles_batch. Price $0.56 per 1,000 requests ($0.000556 per call). Failed calls and empty results are not charged. Each element in usernames counts as one call: the number of elements you send sets the charge. Synchronous only: everything it returns (every target of a batch, or every SKU of a product) is read within this call, and "mode": "async" returns a 422 before any charge.
AI prompt
#Please help me write a data collection script with the EveryInfra Threads Profiles in bulk endpoint (threads/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 threads and action to profiles_batch, and put the parameters inside params.
- Required parameters:
- usernames: Threads accounts for profiles_batch, as an array of up to 20 entries; a comma-separated string is not accepted.
- 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: user_id, username, display_name, bio, follower_count, is_verified, is_private (Whether the account is private), url, avatar_url, external_url (First link in the bio), avatar_hd_url (High-resolution avatar URL), public_view_count (Public views over the last 30 days, the…); 26 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Example request body:
{
"platform": "threads",
"action": "profiles_batch",
"params": {
"usernames": [
"zuck",
"mosseri",
"instagram"
]
}
}
- 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
#| 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 | threads | Platform identifier, fixed value. |
action | body | string | Yes | profiles_batch | Capability identifier, fixed value. |
usernames | body.params | array | Yes | - | Threads accounts for profiles_batch, as an array of up to 20 entries; a comma-separated string is not accepted. Each entry is a username (a leading @ is dropped) or a profile link such as https://www.threads.com/@mosseri. 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 | body.params | integer (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. |
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": "threads",
"action": "profiles_batch",
"params": {
"usernames": [
"zuck",
"mosseri",
"instagram"
]
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
Response example
#{ "id": "req_…", "platform": "threads", "action": "profiles_batch", "results": [ { "user_id": …, "username": …, "display_name": …, "bio": …, "follower_count": …, "is_verified": …, "is_private": …, "url": …, "avatar_url": …, "platform": …, "external_url": …, "avatar_hd_url": …, "public_view_count": …, "public_view_count_start": …, "public_view_count_end": …, "is_fediverse_enabled": …, "is_meta_ai_bot": …, "is_hosting_live_chat": …, "cover_photo_url": …, "transparency_label": …, "bio_links": …, "bio_mentions": …, "topics": …, "bio_links_detail": …, "topics_detail": …, "podcast": …, "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.
| Field | Meaning |
|---|---|
user_id | User's unique ID on the platform. |
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. |
is_verified | Whether the platform verified the account. null means it cannot be determined. |
is_private | Whether the account is private. |
url | Link to the record on the platform. |
avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
external_url | First link in the bio; absent when there is none. |
avatar_hd_url | High-resolution avatar URL. |
public_view_count | Public views over the last 30 days, the number Threads shows publicly on the profile; the start and end dates of the period are in public_view_count_start and public_view_count_end. |
public_view_count_start | Start date of the period public_view_count covers, YYYY-MM-DD. |
public_view_count_end | End date of the period public_view_count covers, YYYY-MM-DD. |
is_fediverse_enabled | Whether fediverse sync is turned on. |
is_meta_ai_bot | The account is a Meta AI bot. Present only when true. |
is_hosting_live_chat | The account is hosting a live chat. Present only when true. |
cover_photo_url | Profile cover photo URL. |
transparency_label | Explanatory label the platform adds to the account, e.g. official media. |
bio_links | All links attached in the bio section. |
bio_mentions | Usernames @-mentioned in the bio. |
topics | Topics attached to the account's profile page. |
bio_links_detail | All links attached in the bio section, each with url, title (link title; only some have it) and is_verified (whether ownership has been verified). |
topics_detail | Topics attached to the profile, each with id, name, display_name and is_community. |
podcast | On posts, the podcast episode card attached to the post: episode_name, episode_url, podcast_name, platform (podcast platform, e.g. SPOTIFY, APPLE) and image_url. In profile (account data), the podcast attached to the profile page: name, url, platform and image_url, and for some also links (listening links per platform, each with platform and url). |
input | profiles_batch and posts_batch: the entry from the request that this row answers, returned exactly as you passed it. |
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.