X (Twitter) Public Data API

Resolve a public X (Twitter) handle with required screenname, without the @ prefix. Optional rest_id is the numeric account ID and takes precedence over screenname; screenname remains required by the request schema. An observed successful response has status=active, profile, rest_id, id, name, desc, website, avatar, header_image, location, created_at, protected, blue_verified and verification_type. Account counters include sub_count (followers), friends (following), statuses_count and media_count; affiliates and business_account may also be present. A nonexistent handle returned status=notfound with null identity and count fields, rather than a profile or numeric zero. Preserve IDs as strings, allow nullable fields and store the collection time with changing public counters. Verification labels are platform metadata, not proof of identity or ownership.

Submit required rest_ids as a comma-separated string of numeric X account IDs. This read is described as returning an array of user profiles for the supplied IDs. Preserve each ID as a string and join records by returned identifiers rather than assuming response order, one result per input or a fixed batch limit. This endpoint has not been live-verified: exact profile fields, accepted batch sizes and unavailable-account behavior require validation before production parsing. Use user-info when a single handle lookup and its observed active/notfound contract are sufficient.

Pass required screenname to retrieve the available registration and usage information associated with a public X profile. This contextual read complements the ordinary user-info profile lookup; it must not be used as proof of a person's location, identity or account ownership. No response sample has been live-verified for this endpoint, so exact metadata keys, historical depth and missing-account behavior are not established. Preserve absent information instead of inventing account-history details.

Pass required screenname to read an account's recent timeline. Optional rest_id overrides the handle selection but does not remove the schema requirement for screenname. Leave cursor empty on the first request, then use the returned next_cursor unchanged for later pages. The observed response has status=ok, timeline, user, next_cursor and prev_cursor. Timeline entries include tweet_id, text, created_at, favorites, retweets, replies, quotes, bookmarks, views, entities, author and media. Reposts can include retweeted and retweeted_tweet; author fields can be null, and views may be a numeric string. Verify author.rest_id against the target, preserve IDs as strings and deduplicate tweet_id across pages. Stop on a missing, empty or repeated next_cursor. Returned page sizes and available history vary; this is not a complete historical archive or a streaming feed.

Supply required screenname for an account's media posts. Optional rest_id and cursor are available; the rest_id selection behavior has not been independently verified, so keep required screenname and validate any ID-based use. The observed response has status=ok, timeline, user and next_cursor. Entries include tweet_id, text, created_at, favorites, retweets, replies, quotes, bookmarks, views, author and nonempty media; observed photos expose media.photo items with media_url_https and id. Media and author details may vary by post. Follow returned cursors only for the same account, retain source post IDs and treat media links as available references rather than permission to republish. This is neither private-media access nor a guaranteed complete media library.

Pass required screenname to request the public replies authored by that account. Optional cursor continues the available account-reply collection; keep the handle unchanged between pages. This is different from latest-replies, which targets replies to one supplied post. Exact reply fields, continuation response keys and empty or unavailable-account shapes have not been live-verified. Treat returned replies as observed conversational activity, not a complete interaction history or private messages.

Pass required query for a keyword or hashtag search. Optional search_type selects a result mode; Latest was verified, while other values and their behavior were not. Start without cursor and continue using the returned next_cursor for the same query and mode. The observed response has status=ok, timeline, next_cursor and prev_cursor. Results include type, tweet_id, screen_name, text, created_at, favorites, retweets, replies, quotes, bookmarks, views, entities, user_info and media; some entries can include quoted content. The NASA query also matched lowercase nasa used by unrelated authors in other languages. Check result text and user_info.rest_id before assigning account identity, deduplicate tweet_id and store query and collection time. Search is a returned-result sample, not an account timeline, native sentiment analysis or guaranteed full-archive access.

Send required id as the string tweet ID from a public post or a previous collection result. The verified response has status=active, id, conversation_id, text, display_text, created_at, likes, retweets, replies, quotes, bookmarks, views, lang, sensitive, author, entities and media. Observed author fields include rest_id, screen_name, name, image, blue_verified, verification and sub_count; a photo post exposes media.photo items with media_url_https and id. Reply-context fields and conversation_control.policy may be null. Preserve large IDs as strings and handle views as a possible numeric string. Public counters can change between calls and are not private impressions or campaign analytics; unavailable-post behavior has not been verified.

Provide required id for the public post whose latest replies you want to inspect. Optional cursor requests another available reply page for that same post. This endpoint targets incoming replies to a particular post, not the replies authored by a selected username. No live sample established exact reply fields, response cursor keys, chronological ordering guarantees or unavailable-post behavior. Validate those shapes before strict parsing, and treat returned discussion as a bounded sample rather than every reply or a push stream.

Pass required id for a public tweet to request basic post information together with available replies. Optional cursor continues the returned discussion where supported. Keep the selected post's context separate from reply entries; this endpoint is not documented as an exhaustive author-written multi-post thread. Field names, pagination output and missing-post behavior have not been live-verified, so validate a successful sample before enforcing a conversation schema. Retain collection limits and omissions in any exported discussion.

Supply required screenname for the account whose follower pages you want. Optional cursor continues the same account's collection; optional blue_verified has documented selector values 0 and 1, but its filtering behavior was not verified. The observed response has status=ok, followers_count, followers, next_cursor and more_users. Follower records include user_id, screen_name, name, profile_image, created_at, followers_count and verification fields. Optional description, website, statuses_count, friends_count, media_count, can_dm or business_account details can be null. The account's total followers_count is not the returned page length. Preserve IDs as strings, deduplicate user_id across available pages and keep collection timestamps. Latest-follower ordering and complete roster coverage were not independently established.

Pass required screenname for the account whose following list you need. Optional rest_id and cursor are available; the rest_id precedence behavior was not independently tested, so retain required screenname and validate any ID-based selection. The observed response has status=ok, following, next_cursor and more_users. Returned profiles include user_id, screen_name, name, description, profile_image, website, created_at, statuses_count, followers_count, friends_count and media_count. Field availability can vary, and these counters describe each returned account, not the selected account's full relationship history. Deduplicate user_id across cursor pages, retain collection time and do not equate missing rows with confirmed unfollows.

Provide required id as the public tweet ID to request available accounts that reposted it. Optional cursor takes the next_cursor value returned by a previous page for the same tweet; this continuation field is documented, but this endpoint's full response shape has not been live-verified. Validate account fields and unavailable-post behavior before joining to profile data. Returned reposters are a collected sample, not a guaranteed complete amplification graph or evidence about quote posts and likes.

Supply required user for the source account and follows for the target account. The read offers a best-effort follow-relationship check and is explicitly limited for large accounts or older relationships. Accepted identifier formatting and exact result fields have not been live-verified; validate a public account pair before building a parser. Use a positive match as supporting evidence, but treat a negative result as inconclusive rather than definitive proof that the source does not follow the target. This endpoint checks a relationship and does not create or remove a follow.

Send required tweet_id for the public post and screenname for the account to check. The described result concerns recent repost activity and may not cover older reposts. Exact status or boolean field names and missing-account or missing-post behavior have not been live-verified. Validate a known public case before depending on the result; a negative check cannot rule out an older repost or prove nonparticipation. This read does not publish a repost, modify the account or measure every form of engagement.

Pass required screenname for a corporate X account to request its available affiliated accounts. Optional cursor continues that account's affiliate collection. Affiliation represents a displayed platform association, not legal ownership, employment or a complete corporate structure. No live response sample established affiliate profile keys, continuation fields or empty-account behavior. Validate returned identifiers and coverage before enriching affiliates through profile or timeline lookups.

Supply required list_id as the string ID of a known public X List. Optional cursor continues available posts from that same List. A List timeline is a collection associated with curated member accounts, not a personalized home feed. Exact post fields, response pagination keys and private or unavailable-List behavior have not been live-verified. Retain the List ID and collection time, validate returned tweet identifiers before deduplication and do not assume complete membership activity or full historical coverage.

Pass required list_id for a known public X List to retrieve its available member accounts. Members are the accounts curated into the List, not the people who subscribe to it; use list-followers for subscribers. Optional cursor continues the member collection. Member profile fields, pagination output and unavailable-List behavior have not been live-verified, so validate returned identifiers before directory enrichment. Snapshot dates and collected coverage must accompany any membership-change claims.

Provide required list_id to request the available accounts that follow a public X List. These are List subscribers, not the curated member accounts returned by list-members. Optional cursor requests another subscriber page for the same List. Subscriber fields, continuation response keys and missing or private-List behavior have not been live-verified. Treat exported records as dated observed coverage rather than a complete subscriber census or proof of audience interests.

Pass required query to discover candidate X Communities for a topic. Optional cursor continues results for the same query. Community discovery is separate from searching posts inside Communities; the latter has dedicated latest- and top-ranked endpoints. Exact community identifiers, descriptive keys, ranking behavior and no-match response shape have not been live-verified. Review returned matches for relevance and validate identifiers before using community-info, community-members or community-posts.

Supply required community_id as the string identifier of a known public X Community. This read requests available descriptive information about that group; it does not return a guaranteed member census or every post. No live sample established exact metadata keys, field completeness or unavailable-Community status. Validate a returned record before building field-level examples, and separate unavailable groups from existing groups with missing descriptive attributes.

Provide required community_id for a public X Community. Optional ranking has documented values Top and Latest; choose one value rather than a comma-separated list. Optional cursor continues the same Community and ranking. This endpoint has not been live-verified, so exact post fields, ranking behavior, continuation keys and unavailable-group results must be validated. Treat collected posts as observed group discussion, not a complete Community archive or built-in topic analysis.

Pass required community_id to request a public X Community's available member accounts. Optional cursor continues the member collection for that same group. Member identifiers, profile attributes, pagination fields and unavailable-group behavior have not been live-verified; validate returned records before profile enrichment or deduplication. Collected membership represents observed coverage, not a complete participant census, private-interest inference or demographic data.

Send required query for a keyword search of latest-ranked posts in X Communities. Optional cursor continues the same query through available results. This endpoint selects a latest-oriented search rather than returning all posts from one community_id. No live sample established exact post or Community-context fields, cursor output, no-match behavior or strict chronological coverage. Validate returned IDs and timestamps before deduplication or change tracking; scheduled polling is not streaming or exhaustive Community monitoring.

Provide required query to request top-ranked matching posts in X Communities. Optional cursor continues available results for the same keyword. Top ranking is endpoint-specific and must not be interpreted as a platform-wide popularity measure or a known engagement formula. Exact post fields, Community context, continuation keys and no-match behavior have not been live-verified. Retain the query and capture time when comparing returned ranked samples.

Supply required country to request available country-specific X trends. Accepted country values and formats have not been live-verified; do not assume the three-letter options used by inspiration-posts also apply here. Exact trend fields, ranking, topic-volume availability and unsupported-country behavior are unverified. Capture request value and collection time with the returned trends, and use observed terms as candidate post-search queries rather than precise user-location evidence.

Choose required country, period and type to request a creator-inspiration post selection. Documented country options include ALL and listed three-letter codes; periods are Daily, Weekly and Monthly, and type values are Likes or Replies. Send one value per selector, never the catalog's comma-separated choice list. This endpoint has not been live-verified: accepted-selector behavior, returned post keys and ranking semantics require validation. Use results as source-linked creative research, not universal content-performance benchmarks or permission to reuse assets.

Send required rest_id as the string numeric X account ID to check available current broadcast status. Resolve a handle to its account ID with user-info if needed; this endpoint does not accept screenname. No live sample established status keys, broadcast identifiers, no-broadcast behavior or update latency. Validate the result before displaying an indicator, debounce scheduled checks and treat observed status changes as polling evidence rather than push delivery. This read does not provide a video stream or start a broadcast.

Pass required id as the X Space identifier from a known public Spaces link. Space IDs can be alphanumeric and are not numeric tweet or user IDs. This read is described as returning basic Spaces information; exact metadata fields, lifecycle states and unavailable-Space behavior have not been live-verified. Validate a sample before rendering session details. Do not promise audio streams, recordings, transcripts, listener identities or a complete attendance history.

Pass required query as a job keyword, such as the documented developer example, to request available X job listings. No location, salary, date or pagination inputs are documented for this read. Exact listing fields, identifiers, source references and no-match behavior have not been live-verified. Validate returned records and deduplicate using stable IDs or URLs only if they are present. Results are an observed job-discovery sample, not complete hiring-market coverage or an application-submission interface.