{"openapi":"3.1.0","info":{"title":"Twitter/X API","version":"1.0.0","description":"![x402 Atlas](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI0OCIgaGVpZ2h0PSI0OCIgdmlld0JveD0iMCAwIDQ4IDQ4IiBmaWxsPSJub25lIj48ZyBzdHJva2U9IiMxRTQwQUYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCI+PHBhdGggZD0iTTI0IDdWMjhNMjQgMjhMOCA0Mk0yNCAyOEw0MCA0MiIgc3Ryb2tlLXdpZHRoPSIyLjEiLz48cGF0aCBkPSJNMjQgN0w4IDQyTTI0IDdMNDAgNDJNMTUgMjhIMzMiIHN0cm9rZS13aWR0aD0iMi43Ii8+PC9nPjxnIGZpbGw9IiMxRTQwQUYiPjxjaXJjbGUgY3g9IjgiIGN5PSI0MiIgcj0iMy4yIi8+PGNpcmNsZSBjeD0iNDAiIGN5PSI0MiIgcj0iMy4yIi8+PGNpcmNsZSBjeD0iMTUiIGN5PSIyOCIgcj0iMy4yIi8+PGNpcmNsZSBjeD0iMzMiIGN5PSIyOCIgcj0iMy4yIi8+PGNpcmNsZSBjeD0iMjQiIGN5PSIyOCIgcj0iMi45Ii8+PC9nPjxjaXJjbGUgY3g9IjI0IiBjeT0iNyIgcj0iNC4yIiBmaWxsPSIjMTRCOEE2Ii8+PC9zdmc+)\n\n**Twitter/X API** is an independently documented x402 Atlas bridge at https://twitter.use.x402atlas.com.\nThis document describes only this bridge; it does not aggregate routes, schemas,\nor content from any other bridge.\n\n## How payment works\n\nPaid operations use the [x402 payment protocol](https://x402.org) and settle in\nUSDC. Atlas supports deployments on Base, Polygon, and Arbitrum, plus configured\nSolana networks. This bridge currently advertises Arbitrum One (`eip155:42161`), Base (`eip155:8453`), Polygon (`eip155:137`).\n\n1. Send the HTTP request without a payment signature.\n2. Read the `402 Payment Required` response. Its `accepts` entries are the\n   authoritative network, asset, amount, and recipient options for that call.\n3. Select an option, sign it with an x402-compatible wallet or SDK, and repeat\n   the request with the `PAYMENT-SIGNATURE` header. The successful response is\n   returned after verification and settlement.\n\nTypeScript clients can automate the challenge, signing, and retry flow with\n[`x402-fetch`](https://www.npmjs.com/package/x402-fetch) or\n[`x402-axios`](https://www.npmjs.com/package/x402-axios). Fund a dedicated\nwallet only with the working USDC balance it needs and keep that key separate\nfrom treasury accounts.\n\n## Pricing\n\nAtlas route prices start at $0.005 per successful call. This bridge's fallback\nprice is $0.005; operations below state their exact configured price in\n`x-x402` and `x-payment-info`. The live `402` challenge remains authoritative.\n\n## Worked payment example\n\nRequest one documented operation without a signature to inspect its live terms:\n\n```bash\ncurl -i 'https://twitter.use.x402atlas.com/autocomplete?query=bill'\n# HTTP/1.1 402 Payment Required\n# Read accepts[].network, asset, amount, and payTo from this response.\n```\n\nSign one accepted option and repeat the identical request with the\n`PAYMENT-SIGNATURE` header. Do not invent or cache payment terms; read them from\nthe current challenge.\n\n## Use this API\n\n- Interactive reference: https://twitter.use.x402atlas.com/docs\n- OpenAPI 3.1 specification: https://twitter.use.x402atlas.com/openapi.json\n- Agent-readable route corpus: https://twitter.use.x402atlas.com/llms.txt\n- Endpoint index: https://twitter.use.x402atlas.com/index.json\n\nUse the operation schemas and examples below to construct requests. Copy the\nserver URL, path, method, parameters, and request body from the operation you\nwant to call. Path and query examples are concrete and can be used directly.\n\n## Atlas response metadata\n\nSuccessful JSON responses include an additive top-level `_atlas` block, kept\nseparate from the bridge's data fields. `_atlas.docs` links this bridge's\n`/llms.txt` corpus. `_atlas.related` suggests adjacent APIs, each with a callable\n`url`, its own `docs` link, and a short `summary`. Suppress this block by sending\n`X-Atlas-Meta: none` or by adding `?_atlas=0` to the request.\n\n## Errors and compatibility\n\nValidation failures use HTTP `400`. Paid operations may return `402` before\ndispatch. Upstream and internal failures use the documented `5xx` responses.\nClients should rely on documented fields and tolerate additive response fields,\nincluding `_atlas` unless they explicitly opt out.\n\n## Protocol reference\n\n- x402 protocol and SDKs: https://x402.org","x-guidance":"Use the operation schemas and examples to construct requests. Paid operations return an HTTP 402 challenge with the authoritative payment terms."},"servers":[{"url":"https://twitter.use.x402atlas.com"}],"tags":[{"name":"Twitter/X API"}],"paths":{"/autocomplete":{"get":{"description":"Return X autocomplete suggestions for a partial free-text `query`, including available user, hashtag, list, topic and event suggestion groups.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_autocomplete","parameters":[{"name":"query","in":"query","required":true,"description":"Partial text to complete","schema":{"description":"Partial text to complete","maxLength":200,"minLength":1,"type":"string"},"example":"bill"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"additionalProperties":true,"type":"object"},"queried_at":{"format":"date-time","type":"string"}},"required":["queried_at","data"],"type":"object"},"example":{"data":{"num_results":10,"query":"bill","users":[{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}]},"queried_at":"2026-07-26T12:00:00Z"}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get X search suggestions for a partial query.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/community-details":{"get":{"description":"Return the complete provider object for one X community, including description, policies, membership counts, rules and viewer-independent metadata.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_community_details","parameters":[{"name":"community_id","in":"query","required":true,"description":"Decimal X community identifier","schema":{"description":"Decimal X community identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"},"example":"1493264213904560130"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"additionalProperties":true,"type":"object"},"queried_at":{"format":"date-time","type":"string"}},"required":["queried_at","data"],"type":"object"},"example":{"data":{"description":"A community for technology discussions","member_count":120000,"name":"Technology","rest_id":"1493264213904560130"},"queried_at":"2026-07-26T12:00:00Z"}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get complete public information for an X community.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/community-media":{"get":{"description":"Return one page of media-bearing posts from an X community, preserving the provider's nested media entities. Use `cursor` to continue.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_community_media","parameters":[{"name":"community_id","in":"query","required":true,"description":"Decimal X community identifier","schema":{"description":"Decimal X community identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"},"example":"1493264213904560130"},{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"created_at":"Sun Mar 23 12:00:00 +0000 2025","favorite_count":120,"full_text":"Example X post","id_str":"1903602810652082591","reply_count":8,"retweet_count":15,"user":{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get media posts from an X community.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/community-members":{"post":{"description":"POST a JSON body containing `community_id` to return one page of community members and their roles. The response may include an opaque next-page cursor.\n\n**Price:** $0.005 per call.","operationId":"twitter_POST_community_members","requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"community_id":{"description":"Decimal X community identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"}},"required":["community_id"]},"example":{"community_id":"1493264213904560130"}}}},"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"community_role":"Admin","is_blue_verified":true,"name":"Mukul Sharma","rest_id":"2901317886","screen_name":"stufflistings"}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get members of an X community.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/community-tweets":{"get":{"description":"Return one page of posts from an X community. `sort` may be `top` or `latest`; pass `cursor` to continue.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_community_tweets","parameters":[{"name":"community_id","in":"query","required":true,"description":"Decimal X community identifier","schema":{"description":"Decimal X community identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"},"example":"1493264213904560130"},{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"sort","in":"query","description":"Community timeline order","schema":{"description":"Community timeline order","enum":["top","latest"],"type":"string"}}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"created_at":"Sun Mar 23 12:00:00 +0000 2025","favorite_count":120,"full_text":"Example X post","id_str":"1903602810652082591","reply_count":8,"retweet_count":15,"user":{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get top or latest posts from an X community.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/list-details":{"get":{"description":"Return the complete provider object for one public X list, including its name, description, owner, member count and subscriber count.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_list_details","parameters":[{"name":"list_id","in":"query","required":true,"description":"Decimal X list identifier","schema":{"description":"Decimal X list identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"},"example":"1309482935804932102"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"additionalProperties":true,"type":"object"},"queried_at":{"format":"date-time","type":"string"}},"required":["queried_at","data"],"type":"object"},"example":{"data":{"description":"Technology accounts and news","id_str":"1309482935804932102","member_count":120,"name":"Technology","subscriber_count":4500},"queried_at":"2026-07-26T12:00:00Z"}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get complete public information for an X list.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/list-followers":{"get":{"description":"Return one page of public user objects following an X list. Use `cursor` for the next page.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_list_followers","parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"list_id","in":"query","required":true,"description":"Decimal X list identifier","schema":{"description":"Decimal X list identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"},"example":"1309482935804932102"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"description":"Sharing things I learn.","followers_count":65000000,"id":50393960,"name":"Bill Gates","profile_image_url_https":"https://pbs.twimg.com/profile_images/example_normal.jpg","screen_name":"BillGates","verified":true}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get followers of a public X list.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/list-members":{"get":{"description":"Return one page of public user objects belonging to an X list. Use `cursor` for the next page.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_list_members","parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"list_id","in":"query","required":true,"description":"Decimal X list identifier","schema":{"description":"Decimal X list identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"},"example":"1309482935804932102"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"description":"Sharing things I learn.","followers_count":65000000,"id":50393960,"name":"Bill Gates","profile_image_url_https":"https://pbs.twimg.com/profile_images/example_normal.jpg","screen_name":"BillGates","verified":true}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get members of a public X list.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/list-tweets":{"get":{"description":"Return one page of posts from accounts in a public X list. Use `cursor` for the next page.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_list_tweets","parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"list_id","in":"query","required":true,"description":"Decimal X list identifier","schema":{"description":"Decimal X list identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"},"example":"1309482935804932102"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"created_at":"Sun Mar 23 12:00:00 +0000 2025","favorite_count":120,"full_text":"Example X post","id_str":"1903602810652082591","reply_count":8,"retweet_count":15,"user":{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get posts from a public X list.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/locations":{"get":{"description":"List every geographic location for which X exposes trends. The route takes no parameters and returns a normalized `locations` array. Each entry contains its numeric Yahoo Where On Earth ID (`woeid`), display `name`, place type, optional parent WOEID, country and ISO country code. Pass a returned `woeid` to `/trends`. The obsolete upstream Yahoo URL is deliberately omitted. `Worldwide` uses WOEID `1` and has no country code.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_locations","responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"location_count":{"minimum":0,"type":"integer"},"locations":{"items":{"properties":{"country":{"type":"string"},"country_code":{"type":"string"},"name":{"type":"string"},"parent_woeid":{"type":"integer"},"place_type":{"type":"string"},"place_type_code":{"type":"integer"},"woeid":{"minimum":1,"type":"integer"}},"required":["woeid","name"],"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"}},"required":["queried_at","location_count","locations"],"type":"object"},"example":{"location_count":2,"locations":[{"name":"Worldwide","place_type":"Supername","place_type_code":19,"woeid":1},{"country":"United States","country_code":"US","name":"Los Angeles","parent_woeid":23424977,"place_type":"Town","place_type_code":7,"woeid":2442047}],"queried_at":"2026-07-26T12:00:00Z"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"List the geographic locations available for Twitter/X trends, including WOEIDs, place types and country details.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/search":{"get":{"description":"Run an X advanced-search query from structured filters and get back one normalized page of up to 20 tweets. **At least one** of `words`, `phrase`, `any_words`, `hashtags`, `from`, `to`, `mentioning`, or `search_query` is required — a request with none of these returns `400`. Optional filters: `none_words`, `filter` (`replies`,`links`,`quote`,`media`,`images`,`videos`), `min_likes`/`min_retweets`/`min_replies` (digits only), `since`/`until` (`YYYY-MM-DD`), `within_time` (e.g. `3h`, `2d`), `near`, `since_id`, `max_id`, `type` (`top` default, `latest`, or `media`), and `cursor` for pagination; `search_query` is a raw-syntax escape hatch merged with the rest. List-valued params accept comma- or space-separated values. Each tweet carries full `text`, `created_at` (RFC3339), engagement metrics (`likes`, `retweets`, `replies`, `quotes`, `bookmarks`, `views`) and a nested `author` profile; the response also echoes the assembled `query` (handy for debugging filter combinations) and a `cursor` for the next page. A search with zero matches is a `200` with `tweets: []`, not an error — page through with `cursor`, or backward by `max_id`.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_search","parameters":[{"name":"any_words","in":"query","description":"Tweets containing any of these words (comma or space separated), e.g. cats,dogs","schema":{"description":"Tweets containing any of these words (comma or space separated), e.g. cats,dogs","type":"string"}},{"name":"cursor","in":"query","description":"Pagination cursor from the previous response","schema":{"description":"Pagination cursor from the previous response","maxLength":2048,"type":"string"}},{"name":"filter","in":"query","description":"Comma- or space-separated content filters. Allowed values are exactly these (case-sensitive, exhaustive): replies, links, quote, media, images, videos. Any other value returns 400. E.g. media,images","schema":{"description":"Comma- or space-separated content filters. Allowed values are exactly these (case-sensitive, exhaustive): replies, links, quote, media, images, videos. Any other value returns 400. E.g. media,images","pattern":"^(replies|links|quote|media|images|videos)([,\\s]+(replies|links|quote|media|images|videos))*$","type":"string"}},{"name":"from","in":"query","description":"Tweets sent by this username (@ optional), e.g. elonmusk","schema":{"description":"Tweets sent by this username (@ optional), e.g. elonmusk","type":"string"}},{"name":"hashtags","in":"query","description":"Tweets with these hashtags (comma or space separated, # optional), e.g. ThrowbackThursday","schema":{"description":"Tweets with these hashtags (comma or space separated, # optional), e.g. ThrowbackThursday","type":"string"}},{"name":"max_id","in":"query","description":"Tweets at or before this tweet ID (inclusive), numeric tweet ID — crawl a timeline backward by passing the lowest ID from the current page","schema":{"description":"Tweets at or before this tweet ID (inclusive), numeric tweet ID — crawl a timeline backward by passing the lowest ID from the current page","pattern":"^[0-9]+$","type":"string"}},{"name":"mentioning","in":"query","description":"Tweets mentioning this username","schema":{"description":"Tweets mentioning this username","type":"string"}},{"name":"min_likes","in":"query","description":"Tweets with at least this many likes (digits only), e.g. 280","schema":{"description":"Tweets with at least this many likes (digits only), e.g. 280","pattern":"^[0-9]+$","type":"string"}},{"name":"min_replies","in":"query","description":"Tweets with at least this many replies (digits only)","schema":{"description":"Tweets with at least this many replies (digits only)","pattern":"^[0-9]+$","type":"string"}},{"name":"min_retweets","in":"query","description":"Tweets with at least this many reposts (digits only)","schema":{"description":"Tweets with at least this many reposts (digits only)","pattern":"^[0-9]+$","type":"string"}},{"name":"near","in":"query","description":"Tweets geotagged near this location, e.g. Berlin or The Hague","schema":{"description":"Tweets geotagged near this location, e.g. Berlin or The Hague","type":"string"}},{"name":"none_words","in":"query","description":"Exclude tweets containing any of these words (comma or space separated)","schema":{"description":"Exclude tweets containing any of these words (comma or space separated)","type":"string"}},{"name":"phrase","in":"query","description":"Tweets containing this exact phrase, e.g. happy hour","schema":{"description":"Tweets containing this exact phrase, e.g. happy hour","type":"string"}},{"name":"search_query","in":"query","description":"Raw X advanced search syntax escape hatch, combined with the structured params above; the combined assembled query must be at most 512 characters","schema":{"description":"Raw X advanced search syntax escape hatch, combined with the structured params above; the combined assembled query must be at most 512 characters","maxLength":512,"type":"string"}},{"name":"since","in":"query","description":"Tweets on or after this date, YYYY-MM-DD","schema":{"description":"Tweets on or after this date, YYYY-MM-DD","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$","type":"string"}},{"name":"since_id","in":"query","description":"Tweets after this tweet ID (exclusive), numeric tweet ID","schema":{"description":"Tweets after this tweet ID (exclusive), numeric tweet ID","pattern":"^[0-9]+$","type":"string"}},{"name":"to","in":"query","description":"Tweets sent in reply to this username","schema":{"description":"Tweets sent in reply to this username","type":"string"}},{"name":"type","in":"query","description":"Result mode: top (default), latest, or media. Latest returns tweets in descending ID order — paginate with cursor or max_id; media selects media-bearing results.","schema":{"default":"top","description":"Result mode: top (default), latest, or media. Latest returns tweets in descending ID order — paginate with cursor or max_id; media selects media-bearing results.","enum":["top","latest","media"],"type":"string"}},{"name":"until","in":"query","description":"Tweets before this date, YYYY-MM-DD","schema":{"description":"Tweets before this date, YYYY-MM-DD","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$","type":"string"}},{"name":"within_time","in":"query","description":"Tweets within a recent window, digits followed by s/m/h/d, e.g. 30s, 5m, 3h, 2d","schema":{"description":"Tweets within a recent window, digits followed by s/m/h/d, e.g. 30s, 5m, 3h, 2d","pattern":"^[0-9]+[smhd]$","type":"string"}},{"name":"words","in":"query","description":"Tweets containing all these words, e.g. what's happening. At least one of words, phrase, any_words, hashtags, from, to, mentioning, search_query is required.","schema":{"description":"Tweets containing all these words, e.g. what's happening. At least one of words, phrase, any_words, hashtags, from, to, mentioning, search_query is required.","type":"string"},"example":"bitcoin"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Pagination cursor for the next page, if any","type":"string"},"queried_at":{"description":"UTC timestamp when this bridge ran the search","format":"date-time","type":"string"},"query":{"description":"The assembled X advanced-search query string sent upstream","type":"string"},"tweet_count":{"description":"Number of tweets in this page","type":"integer"},"tweets":{"items":{"properties":{"author":{"properties":{"avatar":{"type":"string"},"description":{"type":"string"},"followers":{"type":"integer"},"id":{"type":"string"},"name":{"type":"string"},"screen_name":{"type":"string"},"verified":{"description":"Blue-check verification status","type":"boolean"}},"type":"object"},"bookmarks":{"type":"integer"},"conversation_id":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"id":{"description":"Tweet ID","type":"string"},"in_reply_to_id":{"description":"Parent tweet ID, if this is a reply","type":"string"},"in_reply_to_user":{"description":"Parent tweet's author screen name, if this is a reply","type":"string"},"is_quote":{"type":"boolean"},"lang":{"description":"BCP-47 language code","type":"string"},"likes":{"type":"integer"},"quotes":{"type":"integer"},"replies":{"type":"integer"},"retweets":{"type":"integer"},"text":{"type":"string"},"urls":{"description":"Expanded URLs linked in the tweet","items":{"type":"string"},"type":"array"},"views":{"type":"integer"}},"type":"object"},"type":"array"},"type":{"description":"Result ranking used for this page","enum":["top","latest","media"],"type":"string"}},"type":"object"},"example":{"cursor":"DAACCgACHMe1FCaAJxAKAAMcx7UU…","queried_at":"2026-07-05T12:00:00Z","query":"from:@PancakeSwap filter:replies","tweet_count":1,"tweets":[{"author":{"avatar":"https://pbs.twimg.com/profile_images/2004910939959967744/wr7-zpVh_normal.jpg","description":"Everyone's favorite DEX. Swap, trade, and earn across 10+ chains.","followers":2132825,"id":"1305349277422477313","name":"PancakeSwap","screen_name":"PancakeSwap","verified":true},"bookmarks":0,"conversation_id":"2071965667491000381","created_at":"2026-06-30T14:34:45Z","id":"2071965671001608665","is_quote":false,"lang":"en","likes":16,"quotes":0,"replies":1,"retweets":2,"text":"Stack your tokenized assets ⬇️\nhttps://t.co/peohoKiMyQ","urls":["https://pancakeswap.finance/stocks"],"views":3534}],"type":"top"}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Search Twitter/X with structured filters or raw advanced-search syntax. Returns up to 20 normalized tweets with full text, author details, engagement metrics and a pagination cursor.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/search-communities":{"get":{"description":"Search public X communities by free-text `query`. Results include community identity and membership metadata; use `cursor` for the next page.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_search_communities","parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"query","in":"query","required":true,"description":"Community search text","schema":{"description":"Community search text","maxLength":200,"minLength":1,"type":"string"},"example":"technology"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"description":"A community for technology discussions","member_count":120000,"name":"Technology","rest_id":"1493264213904560130"}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Search public X communities by query.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/search-lists":{"get":{"description":"Search public X lists by free-text `query` and return matching list cards with their public identifiers and links.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_search_lists","parameters":[{"name":"query","in":"query","required":true,"description":"List search text","schema":{"description":"List search text","maxLength":200,"minLength":1,"type":"string"},"example":"technology"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"data":[{"object_id":"1309482935804932102","result_contexts":["Technology"],"url":"https://x.com/i/lists/1309482935804932102"}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Search public X lists by query.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/trends":{"get":{"description":"Return the current ranked X trends for one geographic location. `woeid` is required and must be a positive integer returned by `/locations` (`1` is Worldwide; the canonical example uses Los Angeles `2442047`). Each normalized trend contains its rank, display name, reusable X search query, optional context and numeric post count, plus related names in `grouped_trends`. Provider deep links and opaque tracking parameters are removed. Post counts such as `17.1K posts` are normalized to integers; when X does not publish a count, `post_count` is omitted.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_trends","parameters":[{"name":"woeid","in":"query","required":true,"description":"Yahoo Where On Earth ID returned by /locations; 1 means Worldwide","schema":{"description":"Yahoo Where On Earth ID returned by /locations; 1 means Worldwide","minimum":1,"type":"integer"},"example":2442047}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"queried_at":{"format":"date-time","type":"string"},"trend_count":{"minimum":0,"type":"integer"},"trends":{"items":{"properties":{"context":{"type":"string"},"grouped_trends":{"items":{"type":"string"},"type":"array"},"name":{"type":"string"},"post_count":{"minimum":0,"type":"integer"},"rank":{"minimum":1,"type":"integer"},"search_query":{"type":"string"}},"required":["rank","name","search_query","grouped_trends"],"type":"object"},"type":"array"},"woeid":{"minimum":1,"type":"integer"}},"required":["queried_at","woeid","trend_count","trends"],"type":"object"},"example":{"queried_at":"2026-07-26T12:00:00Z","trend_count":2,"trends":[{"context":"Trending in Los Angeles","grouped_trends":[],"name":"#FogoChain","post_count":17100,"rank":1,"search_query":"#FogoChain"},{"context":"Business and finance · Trending","grouped_trends":["Greg Abel","CEO of Berkshire Hathaway"],"name":"Warren Buffett","post_count":21600,"rank":2,"search_query":"\"Warren Buffett\""}],"woeid":2442047}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get ranked Twitter/X trends for a geographic WOEID with normalized search queries, context, post counts and related trends.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/tweet-details":{"get":{"description":"Return the provider's complete post object for a decimal `tweet_id`, including text, author, engagement, conversation and entity fields.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_tweet_details","parameters":[{"name":"tweet_id","in":"query","required":true,"description":"Decimal X post identifier","schema":{"description":"Decimal X post identifier","maxLength":25,"pattern":"^[0-9]{1,25}$","type":"string"},"example":"1903602810652082591"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"additionalProperties":true,"type":"object"},"queried_at":{"format":"date-time","type":"string"}},"required":["queried_at","data"],"type":"object"},"example":{"data":{"created_at":"Sun Mar 23 12:00:00 +0000 2025","favorite_count":120,"full_text":"Example X post","id_str":"1903602810652082591","reply_count":8,"retweet_count":15,"user":{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}},"queried_at":"2026-07-26T12:00:00Z"}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get the complete public data for one X post.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/user-about":{"get":{"description":"Return X's extended About profile object for one username, including the available account metadata and verification information.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_user_about","parameters":[{"name":"username","in":"query","required":true,"description":"X username, with or without a leading @","schema":{"description":"X username, with or without a leading @","maxLength":16,"pattern":"^@?[A-Za-z0-9_]{1,15}$","type":"string"},"example":"BillGates"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"additionalProperties":true,"type":"object"},"queried_at":{"format":"date-time","type":"string"}},"required":["queried_at","data"],"type":"object"},"example":{"data":{"about_profile":{"source":"profile"},"core":{"name":"Bill Gates","screen_name":"BillGates"},"is_blue_verified":true,"rest_id":"50393960"},"queried_at":"2026-07-26T12:00:00Z"}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get the extended About information for a public X user.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/user-details":{"get":{"description":"Return the complete provider profile object for one public X username, including identity, biography, verification, counts, avatar and relationship fields. The nested `data` object is preserved because X adds profile fields over time.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_user_details","parameters":[{"name":"username","in":"query","required":true,"description":"X username, with or without a leading @","schema":{"description":"X username, with or without a leading @","maxLength":16,"pattern":"^@?[A-Za-z0-9_]{1,15}$","type":"string"},"example":"BillGates"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"additionalProperties":true,"type":"object"},"queried_at":{"format":"date-time","type":"string"}},"required":["queried_at","data"],"type":"object"},"example":{"data":{"core":{"name":"Bill Gates","screen_name":"BillGates"},"is_blue_verified":true,"legacy":{"description":"Sharing things I learn.","followers_count":65000000},"rest_id":"50393960"},"queried_at":"2026-07-26T12:00:00Z"}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get a complete public X user profile by username.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/user-highlights":{"get":{"description":"Return one page of posts highlighted on a public X profile. The route supports the provider's opaque pagination cursor.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_user_highlights","parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"username","in":"query","required":true,"description":"X username, with or without a leading @","schema":{"description":"X username, with or without a leading @","maxLength":16,"pattern":"^@?[A-Za-z0-9_]{1,15}$","type":"string"},"example":"BillGates"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"created_at":"Sun Mar 23 12:00:00 +0000 2025","favorite_count":120,"full_text":"Example X post","id_str":"1903602810652082591","reply_count":8,"retweet_count":15,"user":{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get the highlighted posts selected on an X user profile.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/user-media":{"get":{"description":"Return one page of media-bearing posts from a public X user, including the provider's nested media entities and pagination cursor.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_user_media","parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"username","in":"query","required":true,"description":"X username, with or without a leading @","schema":{"description":"X username, with or without a leading @","maxLength":16,"pattern":"^@?[A-Za-z0-9_]{1,15}$","type":"string"},"example":"BillGates"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"created_at":"Sun Mar 23 12:00:00 +0000 2025","favorite_count":120,"full_text":"Example X post","id_str":"1903602810652082591","reply_count":8,"retweet_count":15,"user":{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get a paginated timeline of media posts from an X user.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/user-replies":{"get":{"description":"Return one page of replies and conversation posts from a public X user. Pass the returned `cursor` to continue.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_user_replies","parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"username","in":"query","required":true,"description":"X username, with or without a leading @","schema":{"description":"X username, with or without a leading @","maxLength":16,"pattern":"^@?[A-Za-z0-9_]{1,15}$","type":"string"},"example":"BillGates"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"created_at":"Sun Mar 23 12:00:00 +0000 2025","favorite_count":120,"full_text":"Example X post","id_str":"1903602810652082591","reply_count":8,"retweet_count":15,"user":{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get a paginated timeline of replies from an X user.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}},"/user-tweets":{"get":{"description":"Return one page of posts published by a public X user. Pass the returned `cursor` to retrieve the next page.\n\n**Price:** $0.005 per call.","operationId":"twitter_GET_user_tweets","parameters":[{"name":"cursor","in":"query","description":"Opaque pagination cursor from the previous response","schema":{"description":"Opaque pagination cursor from the previous response","maxLength":4096,"minLength":1,"type":"string"}},{"name":"username","in":"query","required":true,"description":"X username, with or without a leading @","schema":{"description":"X username, with or without a leading @","maxLength":16,"pattern":"^@?[A-Za-z0-9_]{1,15}$","type":"string"},"example":"BillGates"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"properties":{"cursor":{"description":"Opaque cursor for the next page, when supplied by X","type":"string"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"queried_at":{"format":"date-time","type":"string"},"result_count":{"minimum":0,"type":"integer"}},"required":["queried_at","data","result_count"],"type":"object"},"example":{"cursor":"NEXT_PAGE_CURSOR","data":[{"created_at":"Sun Mar 23 12:00:00 +0000 2025","favorite_count":120,"full_text":"Example X post","id_str":"1903602810652082591","reply_count":8,"retweet_count":15,"user":{"id_str":"50393960","name":"Bill Gates","screen_name":"BillGates"}}],"queried_at":"2026-07-26T12:00:00Z","result_count":1}}}},"400":{"description":"Validation error — the request was rejected before the handler ran.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. The response carries an x402 payment challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"500":{"description":"Unexpected internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"x402Payment":[]}],"summary":"Get a paginated timeline of posts from an X user.","tags":["Twitter/X API"],"x-payment-info":{"price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-x402":{"discoverable":true,"enabled":true,"paid":true,"price":"$0.005","service_name":"Twitter/X API"}}}},"components":{"schemas":{"Error":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"}},"required":["error"],"type":"object"},"PaymentRequired":{"description":"x402 payment-required envelope. The exact shape comes from the x402 SDK and includes per-network accepted payment options. See https://x402.org for the canonical schema.","type":"object"}},"securitySchemes":{"x402Payment":{"description":"Pay the route via x402 (https://x402.org). The 402 response carries the payment challenge; resubmit with a PAYMENT-SIGNATURE header.","scheme":"x402","type":"http"}}}}