X (Twitter) Details API

Q: How do I track an account's growth over time?

Call it on a schedule and store follower_count, following_count and post_count with the date of each call, keyed on user_id. Each call is one snapshot, so the series is only as fine-grained as your schedule, and a null value marks a gap rather than a drop to zero.

POST

API health

24h health: Normal

Healthy / normal
Available
Limited
Mostly down

Last 24 hours

Last 30 days

Check an X (Twitter) handle's bio, location, follower, following and post counts, verification and account creation date. Pass the username with or without @, not a profile URL. The result does not confirm identity, current activity or audience makeup.

Send POST https://api.everyinfra.com/api/v1/social with platform set to twitter and action set to profile. Price $0.56 per 1,000 requests ($0.000556 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.

X (Twitter) Details reads the public profile of one X account from its username and returns a single record: user_id, handle, display name, bio, location, profile link, avatar, follower, following and post counts, verification and the date the account was created. Marketers, journalists and analysts use it to check who is behind a handle and how large and active the account is: vetting creators before a campaign, confirming an official account before citing it, or enriching a list of handles with audience size.

display_name is the name shown on the profile and can differ from the handle, so match accounts on username, or better on user_id, the account's unique ID on X. The bio may include line breaks and emoji. A null follower_count, following_count or post_count means the number was not disclosed, and a null is_verified means verification could not be determined.

AI prompt

Please help me write a data collection script with the EveryInfra X (Twitter) Details endpoint (twitter/profile).

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 twitter and action to profile, and put the parameters inside params.
- Required parameters:
  - username: X username, optionally prefixed with @, without entering a full profile URL. profile compiles data from author details within recent posts.
- Returns one object. Main fields: user_id, username, display_name, bio, url, follower_count, following_count, post_count, is_verified, location, avatar_url, created_at.
- Example request body:
{
  "platform": "twitter",
  "action": "profile",
  "params": {
    "username": "nasa"
  }
}
- 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	`twitter`	Platform identifier, fixed value.
`action`	body	`string`	Yes	`profile`	Capability identifier, fixed value.
`username`	body.params	`string`	Yes	-	X username, optionally prefixed with @, without entering a full profile URL. profile compiles data from author details within recent posts; followers_list and following_list retrieve visible followers and following accounts respectively.

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": "twitter",
  "action": "profile",
  "params": {
    "username": "nasa"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

Response example

json

{  "id": "req_…",  "platform": "twitter",  "action": "profile",  "results": {    "user_id": "•••",    "username": "NASA",    "display_name": "NASA",    "url": "https://x.com/NASA",    "follower_count": 92375075,    "following_count": 115,    "post_count": 74334,    "is_verified": true,    "location": "Pale Blue Dot",    "avatar_url": "https://pbs.twimg.com/•••",    "created_at": "Wed Dec 19 20:20:32 +0000 2007",    "platform": "twitter"  },  "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.
`url`	Link to the record on the platform.
`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_verified`	Whether the platform verified the account. null means it cannot be determined.
`location`	Location description passed through as is; the format varies by platform.
`avatar_url`	Avatar image link. Some platforms return sized CDN links that can expire.
`created_at`	Creation time, same format as posted_at.
`platform`	Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

FAQ

What do I pass as `username`?

The handle that follows x.com/ in the profile link, such as nasa; a leading @ is fine. Pass neither the full link nor the display name: the field takes the handle only, and display_name in the result is the separate name shown on the profile.

How do I track an account's growth over time?

Call it on a schedule and store follower_count, following_count and post_count with the date of each call, keyed on user_id. Each call is one snapshot, so the series is only as fine-grained as your schedule, and a null value marks a gap rather than a drop to zero.

How do I get the account's posts and followers?

This capability returns the profile only. Pass the same handle to X (Twitter) Posts by user for the account's posts, or to Follower list and Following list for the accounts on either side of its follow graph; all three take username in the same form.

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

Official references

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

X: username / handle vs. Display Name ↗
X separates the handle from the display name; the handle forms the @ identifier and profile link, and once changed, the original handle may be claimed by others. When archiving, do not rely solely on display names or mutable handles to verify identity.
Checked 2026-09-04