EveryData platform API

X (Twitter) API

Q: What can I retrieve with the X (Twitter) API?

Set `platform` to `twitter`. The current catalog lists search, profiles, posts by user, post details, comments, and more. These action names identify different X (Twitter) objects or views; they are not interchangeable search modes.

Q: Which fields can X (Twitter) `search` return?

Its declared schema includes `text`, `like_count`, `retweet_count`, and `reply_count`. A declared field can still be absent from an individual source record, and every other action has its own field list.

X (Twitter) exposes eight action-specific views for profiles, posts, replies, trends, follower lists, and following lists: `search`, `profile`, `user_posts`, `post`, `comments`, `trending`, `followers_list`, and `following_list`.

X (Twitter) begins with `search`, where `keyword` selects matching public results; the adjacent `profile` view uses `username` for the selected X (Twitter) record, leaving other capabilities unclaimed.

Start for free View the public catalog

Endpoint: POST /api/v1/social
Capabilities: 8
Per 1,000: $0.556

Available capabilities

Compare the X (Twitter) actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.

Action	Required	Optional	Delivery	Limit	Per 1,000	Response fields
`search` Search Search public results on X (Twitter). Accepts these parameters: `sort` and `keyword`. Returns these fields: `view_count`, `like_count`, `author_url`, and `author_follower_count`.	keyword	sort	Sync delivery	Catalog values: defaultLimit=25, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform
`profile` Profiles Retrieve public profile details from X (Twitter). Accepts these parameters: `username`. Returns these fields: `username`, `bio`, `avatar_url`, and `follower_count`.	username	—	Sync delivery	—	$0.56 per 1,000 requests	user_id · username · display_name · bio · url · follower_count · following_count · post_count · is_verified · location · avatar_url · created_at · platform
`user_posts` Posts by user Retrieve public posts from X (Twitter). Accepts these parameters: `username`. Returns these fields: `author_username`, `author_url`, `posted_at`, and `like_count`.	username	—	Sync delivery	Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform
`post` Post details Retrieve a public post from X (Twitter). Accepts these parameters: `tweet_id` and `id`. Returns these fields: `retweet_count`, `author_url`, `text`, and `author_username`.	id	tweet_id	Sync delivery	—	$0.56 per 1,000 requests	id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform
`comments` Comments Retrieve public comments from X (Twitter). Accepts these parameters: `tweet_id` and `id`. Returns these fields: `view_count`, `text`, `like_count`, and `retweet_count`.	id	tweet_id	Sync delivery	Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · platform
`trending` Trending Retrieve current trends from X (Twitter). Accepts these parameters: `country`. Returns these fields: `name`, `rank`, `volume`, and `collected_at`.		country	Sync delivery	—	$0.56 per 1,000 requests	id · name · rank · volume · period · collected_at · platform
`followers_list` Follower list Retrieve accounts following the selected X (Twitter) account. Accepts these parameters: `username`. Returns these fields: `is_protected`, `post_count`, `name`, and `location`.	username	—	Sync delivery	Catalog values: defaultLimit=200, maxLimit=2000. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform
`following_list` Following list Retrieve accounts followed by the selected X (Twitter) account. Accepts these parameters: `username`. Returns these fields: `follower_count`, `location`, `name`, and `is_protected`.	username	—	Sync delivery	Catalog values: defaultLimit=200, maxLimit=2000. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform

What does each X (Twitter) action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

What do the X (Twitter) `search` parameters mean?

Search public results on X (Twitter). Accepts these parameters: sort and keyword. Returns these fields: view_count, like_count, author_url, and author_follower_count.

keywordRequired: X post query string, which may include platform search syntax. The primary search path remains fixed to Top, and current sorting cannot be forced to latest via sort.
sortOptional: Compatibility parameter for requesting latest results on the search path, while the primary search path remains fixed to Top. This is not a stable public sorting option and should not be relied upon to return latest search results.

What do the X (Twitter) `profile` parameters mean?

Retrieve public profile details from X (Twitter). Accepts these parameters: username. Returns these fields: username, bio, avatar_url, and follower_count.

usernameRequired: 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.
X: username / handle vs. Display NameX 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

What do the X (Twitter) `user_posts` parameters mean?

Retrieve public posts from X (Twitter). Accepts these parameters: username. Returns these fields: author_username, author_url, posted_at, and like_count.

usernameRequired: 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.
X: username / handle vs. Display NameX 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

What do the X (Twitter) `post` parameters mean?

Retrieve a public post from X (Twitter). Accepts these parameters: tweet_id and id. Returns these fields: retweet_count, author_url, text, and author_username.

idRequired: Numeric post ID for post or comments, corresponding to the digits following x.com/username/status/. It is recommended to store this as a string to prevent JavaScript large integer precision loss; do not pass full URLs into id.
X: View Count Does Not Equal Unique UsersX clarifies that multiple views by the same person may count multiple times, and some posts have no view count available. This explains metric definitions and does not mean this endpoint can access protected content or private analytics data.Checked 2026-09-04
tweet_idOptional: Compatibility input for id, with lower precedence than id, which does not replace the required public id field.

What do the X (Twitter) `comments` parameters mean?

Retrieve public comments from X (Twitter). Accepts these parameters: tweet_id and id. Returns these fields: view_count, text, like_count, and retweet_count.

idRequired: Numeric post ID for post or comments, corresponding to the digits following x.com/username/status/. It is recommended to store this as a string to prevent JavaScript large integer precision loss; do not pass full URLs into id.
X: Original Post ID, Conversation ID, and Reply RelationshipsX uses conversation_id to indicate the original post ID that initiated a conversation, which multi-level replies can share; reconstructing parent-child relationships requires parent post identifiers. This endpoint does not expose these relationship fields, so official example reply trees should not be expected in current output.Checked 2026-09-04
tweet_idOptional: Compatibility input for id, with lower precedence than id, which does not replace the required public id field.

What do the X (Twitter) `trending` parameters mean?

Retrieve current trends from X (Twitter). Accepts these parameters: country. Returns these fields: name, rank, volume, and collected_at.

countryOptional: Region code for trending, with world as the global default. Supports us, ca, mx, uk/gb, fr, de, it, es, pt, nl, dk, at, be, ch, gr, ru, tr, kr, sg, id, ph, vn, th, au, il, ae, sa, ar, br, eg, ng, ke, za, jp, along with select English country name mappings. Unrecognized inputs fall back to the global ranking.
X: Regional Trends vs. Personalized RecommendationsX distinguishes regional trends from personalized recommendations driven by location and interest signals. This helps explain country parameter usage but does not guarantee return order matches a specific user's recommendation page, nor does it provide official trend model scores.Checked 2026-09-04

What do the X (Twitter) `followers_list` parameters mean?

Retrieve accounts following the selected X (Twitter) account. Accepts these parameters: username. Returns these fields: is_protected, post_count, name, and location.

usernameRequired: 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.
X: Direction of Followers vs. FollowingX separately explains who follows you and who you follow, as following does not need to be mutual; protected posts have additional access restrictions. List queries are not bulk-follow actions and do not imply expanded access permissions.Checked 2026-09-04

What do the X (Twitter) `following_list` parameters mean?

Retrieve accounts followed by the selected X (Twitter) account. Accepts these parameters: username. Returns these fields: follower_count, location, name, and is_protected.

usernameRequired: 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.
X: Direction of Followers vs. FollowingX separately explains who follows you and who you follow, as following does not need to be mutual; protected posts have additional access restrictions. List queries are not bulk-follow actions and do not imply expanded access permissions.Checked 2026-09-04

How to use the X (Twitter) API

01Read the public catalog and choose a platform action.
02Send the platform, action, and required parameters to POST /api/v1/social.
03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
04Store the structured response fields needed by your application.

twitter_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"twitter","action":"search","params":{"keyword":"<keyword>"}}'

X (Twitter) API questions

What can I retrieve with the X (Twitter) API?

Set platform to twitter. The current catalog lists search, profiles, posts by user, post details, comments, and more. These action names identify different X (Twitter) objects or views; they are not interchangeable search modes.

Which input starts a X (Twitter) `search` request?

X post query string, which may include platform search syntax. The primary search path remains fixed to Top, and current sorting cannot be forced to latest via sort. Send it as keyword inside params.

Which fields can X (Twitter) `search` return?

Its declared schema includes text, like_count, retweet_count, and reply_count. A declared field can still be absent from an individual source record, and every other action has its own field list.

Does every X (Twitter) action return immediately?

No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API View the public catalog →

X (Twitter) API

Available capabilities

What does each X (Twitter) action accept?

What do the X (Twitter) search parameters mean?

What do the X (Twitter) profile parameters mean?

What do the X (Twitter) user_posts parameters mean?

What do the X (Twitter) post parameters mean?

What do the X (Twitter) comments parameters mean?

What do the X (Twitter) trending parameters mean?

What do the X (Twitter) followers_list parameters mean?

What do the X (Twitter) following_list parameters mean?