Platform availability
- 24h health
- 79%
Last 30 days
Available capabilities
Each X (Twitter) action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Search X (Twitter) posts with a keyword query that may include operators such as from: or since:, and get text, author, follower count and engagement counts. | $0.56 per 1,000 requests | Healthy · health 98% |
Profilesprofile | Check an X (Twitter) handle's bio, location, follower, following and post counts, verification and account creation date. | $0.56 per 1,000 requests | Normal |
Posts by useruser_posts | Pull an X (Twitter) account's posts with likes, reposts, replies and views for each, plus publish time. | $0.56 per 1,000 requests | Available · health 88% |
Post detailspost | Fetch one X (Twitter) post by its numeric ID, with full text, author, publish time and like, repost, reply and view counts. | $0.56 per 1,000 requests | Normal |
Commentscomments | Collect the replies under an X (Twitter) post, each with text, author, the author's follower count and its own engagement numbers. | $0.56 per 1,000 requests | Normal |
Trendingtrending | List trending topics on X (Twitter) with rank, discussion volume, time period and the moment each was collected. | $0.56 per 1,000 requests | Normal |
Follower listfollowers_list | Map the audience of an X (Twitter) account through its followers, each with bio, location, counts, verification and protected status. | $0.56 per 1,000 requests | Normal |
Following listfollowing_list | Get the accounts an X (Twitter) user follows, with each one's bio, location, follower and post counts and verification. | $0.56 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
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.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search X (Twitter) posts with a keyword query that may include operators such as from: or since:, and get text, author, follower count and engagement counts. Top results come first by default; asking for the latest posts does not guarantee strict chronological order. | 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 |
profileProfiles 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. | 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_postsPosts by user Pull an X (Twitter) account's posts with likes, reposts, replies and views for each, plus publish time. One batch may not hold every post, reply or repost, and private messages are never included. | 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 |
postPost details Fetch one X (Twitter) post by its numeric ID, with full text, author, publish time and like, repost, reply and view counts. Keep the ID as a string to avoid JavaScript rounding, and do not pass the full link. | 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 |
commentsComments Collect the replies under an X (Twitter) post, each with text, author, the author's follower count and its own engagement numbers. Send the original post's numeric | 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 |
trendingTrending List trending topics on X (Twitter) with rank, discussion volume, time period and the moment each was collected. Choose a region with | country | Sync delivery | — | $0.56 per 1,000 requests | id · name · rank · volume · period · collected_at · platform | |
followers_listFollower list Map the audience of an X (Twitter) account through its followers, each with bio, location, counts, verification and protected status. The list covers followers X makes visible and may be partial; the counts on each row belong to that follower. | 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_listFollowing list Get the accounts an X (Twitter) user follows, with each one's bio, location, follower and post counts and verification. Following can change at any time and does not prove affinity or interaction. | 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 do the X (Twitter) search parameters mean?
Search X (Twitter) posts with a keyword query that may include operators such as from: or since:, and get text, author, follower count and engagement counts. Top results come first by default; asking for the latest posts does not guarantee strict chronological order.
Full API reference: parameters, code samples, response example and health →keywordRequired- X post query string; it may include platform search operators such as from: or since:. For ordering, see sort.
sortOptional- Ordering preference. latest asks for the newest posts first; X returns Top results by default, and latest does not guarantee strictly chronological results.
What do the X (Twitter) profile parameters mean?
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.
Full API reference: parameters, code samples, response example and health →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 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
What do the X (Twitter) user_posts parameters mean?
Pull an X (Twitter) account's posts with likes, reposts, replies and views for each, plus publish time. One batch may not hold every post, reply or repost, and private messages are never included.
Full API reference: parameters, code samples, response example and health →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 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
What do the X (Twitter) post parameters mean?
Fetch one X (Twitter) post by its numeric ID, with full text, author, publish time and like, repost, reply and view counts. Keep the ID as a string to avoid JavaScript rounding, and do not pass the full link.
Full API reference: parameters, code samples, response example and health →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 Users — X 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
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?
Collect the replies under an X (Twitter) post, each with text, author, the author's follower count and its own engagement numbers. Send the original post's numeric id; the full conversation is not guaranteed.
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 Relationships — X 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
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?
List trending topics on X (Twitter) with rank, discussion volume, time period and the moment each was collected. Choose a region with country, world by default; rank and volume describe one observation, not the algorithm or a history.
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, and some English country names. Unrecognized inputs return the global ranking.X: Regional Trends vs. Personalized Recommendations — X 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
What do the X (Twitter) followers_list parameters mean?
Map the audience of an X (Twitter) account through its followers, each with bio, location, counts, verification and protected status. The list covers followers X makes visible and may be partial; the counts on each row belong to that follower.
Full API reference: parameters, code samples, response example and health →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. Following — X 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
What do the X (Twitter) following_list parameters mean?
Get the accounts an X (Twitter) user follows, with each one's bio, location, follower and post counts and verification. Following can change at any time and does not prove affinity or interaction.
Full API reference: parameters, code samples, response example and health →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. Following — X 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
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 action runs asynchronously.
- 04Store the structured response fields needed by your application.
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) guides
Worked examples and methods built on these actions. Check the current actions, parameters and fields on this page first; an article's examples and limits do not replace the live catalog.
Multiplatform Reputation Monitoring Blueprint: Define Scope Before Evaluating Negative Shifts
Design a traceable reputation monitoring workflow starting with target lists, comment identities, and incremental cursors; use offline samples to demonstrate deduplication and ingestion gaps while preserving manual review.
Read the article →Unified Data API Getting Started: From Capability Catalog to First Available Result
Access multi-platform data using platform, action, and params: read the capability catalog, complete minimal requests, handle asynchronous tasks, partial results, and billing, and establish traceable data records.
Read the article →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.
Does X (Twitter) have an official API?
Yes. The X API v2 is open to any developer through the X Developer Console. Since February 2026 it is billed pay-per-use: you buy credits and pay per resource, for example $0.005 per post read and $0.010 per user read, with a cap of 3 million post reads a month before an Enterprise plan is needed (prices as published in October 2026).
Official sources: X API pricing · X API: getting access · Checked
Do I need a X (Twitter) developer account or API key?
No. Requests go through EveryInfra with an EveryInfra API key: sign up, create a key in the console and send it as Authorization: Bearer <API_KEY>. You do not register a X (Twitter) developer app, apply for X (Twitter) API access or sign in with a X (Twitter) account, and the actions return public X (Twitter) data only.
How much does the X (Twitter) API cost per 1,000 requests?
$0.56 per 1,000 requests, depending on the action; each action's price is listed in the table on this page and in the public catalog. There is no subscription: you top up a USD balance and pay per call, and failed calls and empty results are not charged.
Which input starts a X (Twitter) `search` request?
X post query string; it may include platform search operators such as from: or since:. For ordering, see 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 record, and every other action has its own field list.
Does every X (Twitter) action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.