Twitter/X API
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.
Offering
- Provider
- twitter.use.x402atlas.com
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Social Intelligence
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://twitter.use.x402atlas.com/search- MIME type
- application/json
- First seen
- 2026-10-16T01:50:06.715Z
- Last seen
- Tags
- Twitter, x, tweet-search, twitter-scraper, social-media, advanced-search, tweets, social-listening, twitter-api, x-search
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact - Payment option 2
- 0.005 USDC
Atomic price: 5000 · Network: eip155:137 · Asset: USDC · Scheme: exact - Payment option 3
- 0.005 USDC
Atomic price: 5000 · Network: eip155:42161 · Asset: USDC · Scheme: exact - Payment option 4
- 0.005 USDC
Atomic price: 5000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B"
},
{
"scheme": "exact",
"network": "eip155:137",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "5000",
"payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B"
},
{
"scheme": "exact",
"network": "eip155:42161",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "5000",
"payTo": "0x51D577C8CBB8b3fB1BA0CE31c7923cC27a07F78B"
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "5000",
"payTo": "3nXsChcZGke6xebDPmndNMCt8L3yi6xyN4Pd6q5cQrgv"
}
]Observed health
- Status
- Healthy
- Latest latency
- 12 ms
- Average latency
- 314 ms
- HTTP status
- 402
- Last checked
- Reachability
- 100% over 10 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"any_words": {
"description": "Any of these words",
"example": "btc,eth",
"type": "string"
},
"cursor": {
"description": "Pagination cursor",
"maxLength": 2048,
"type": "string"
},
"filter": {
"description": "Content filters: replies, links, quote, media, images, videos",
"example": "media,images",
"pattern": "^(replies|links|quote|media|images|videos)([,\\s]+(replies|links|quote|media|images|videos))*$",
"type": "string"
},
"from": {
"description": "Tweets from this username",
"example": "elonmusk",
"type": "string"
},
"hashtags": {
"description": "Filter by hashtags",
"example": "bitcoin,eth",
"type": "string"
},
"max_id": {
"description": "Tweets at or before this tweet ID",
"pattern": "^[0-9]+$",
"type": "string"
},
"mentioning": {
"description": "Tweets mentioning this username",
"type": "string"
},
"min_likes": {
"description": "Minimum like count",
"type": "integer"
},
"min_replies": {
"description": "Minimum reply count",
"type": "integer"
},
"min_retweets": {
"description": "Minimum retweet count",
"type": "integer"
},
"near": {
"description": "Tweets near this location",
"type": "string"
},
"none_words": {
"description": "Exclude these words",
"example": "airdrop,giveaway",
"type": "string"
},
"phrase": {
"description": "Exact phrase match",
"type": "string"
},
"q": {
"description": "Short alias of search_query",
"maxLength": 512,
"type": "string"
},
"query": {
"description": "Alias of search_query",
"maxLength": 512,
"type": "string"
},
"search_query": {
"description": "Raw X advanced search query",
"maxLength": 512,
"type": "string"
},
"since": {
"description": "Start date (YYYY-MM-DD)",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"type": "string"
},
"since_id": {
"description": "Tweets after this tweet ID",
"pattern": "^[0-9]+$",
"type": "string"
},
"to": {
"description": "Tweets replying to this username",
"type": "string"
},
"type": {
"default": "top",
"description": "Result mode: top, latest or media",
"enum": [
"top",
"latest",
"media"
],
"type": "string"
},
"until": {
"description": "End date (YYYY-MM-DD)",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"type": "string"
},
"within_time": {
"description": "Recent time window: digits plus s, m, h or d",
"pattern": "^[0-9]+[smhd]$",
"type": "string"
},
"words": {
"description": "All these words must appear",
"example": "bitcoin",
"type": "string"
}
},
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"any_words": {
"description": "Any of these words",
"example": "btc,eth",
"type": "string"
},
"cursor": {
"description": "Pagination cursor",
"maxLength": 2048,
"type": "string"
},
"filter": {
"description": "Content filters: replies, links, quote, media, images, videos",
"example": "media,images",
"pattern": "^(replies|links|quote|media|images|videos)([,\\s]+(replies|links|quote|media|images|videos))*$",
"type": "string"
},
"from": {
"description": "Tweets from this username",
"example": "elonmusk",
"type": "string"
},
"hashtags": {
"description": "Filter by hashtags",
"example": "bitcoin,eth",
"type": "string"
},
"max_id": {
"description": "Tweets at or before this tweet ID",
"pattern": "^[0-9]+$",
"type": "string"
},
"mentioning": {
"description": "Tweets mentioning this username",
"type": "string"
},
"min_likes": {
"description": "Minimum like count",
"type": "integer"
},
"min_replies": {
"description": "Minimum reply count",
"type": "integer"
},
"min_retweets": {
"description": "Minimum retweet count",
"type": "integer"
},
"near": {
"description": "Tweets near this location",
"type": "string"
},
"none_words": {
"description": "Exclude these words",
"example": "airdrop,giveaway",
"type": "string"
},
"phrase": {
"description": "Exact phrase match",
"type": "string"
},
"q": {
"description": "Short alias of search_query",
"maxLength": 512,
"type": "string"
},
"query": {
"description": "Alias of search_query",
"maxLength": 512,
"type": "string"
},
"search_query": {
"description": "Raw X advanced search query",
"maxLength": 512,
"type": "string"
},
"since": {
"description": "Start date (YYYY-MM-DD)",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"type": "string"
},
"since_id": {
"description": "Tweets after this tweet ID",
"pattern": "^[0-9]+$",
"type": "string"
},
"to": {
"description": "Tweets replying to this username",
"type": "string"
},
"type": {
"default": "top",
"description": "Result mode: top, latest or media",
"enum": [
"top",
"latest",
"media"
],
"type": "string"
},
"until": {
"description": "End date (YYYY-MM-DD)",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"type": "string"
},
"within_time": {
"description": "Recent time window: digits plus s, m, h or d",
"pattern": "^[0-9]+[smhd]$",
"type": "string"
},
"words": {
"description": "All these words must appear",
"example": "bitcoin",
"type": "string"
}
},
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"cursor": {
"description": "Pagination cursor for the next page, if any",
"type": "string"
},
"queried_at": {
"description": "UTC timestamp when this service 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"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}