GET
$0.0079 default
/searchDescription
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.
Pricing
$0.0079 default
Parameters
{
"properties": {
"any_words": {
"description": "Any of these words",
"type": "string"
},
"cursor": {
"description": "Pagination cursor",
"maxLength": 2048,
"type": "string"
},
"filter": {
"description": "Content filters: replies, links, quote, media, images, videos",
"pattern": "^(replies|links|quote|media|images|videos)([,\\s]+(replies|links|quote|media|images|videos))*$",
"type": "string"
},
"from": {
"description": "Tweets from this username",
"type": "string"
},
"hashtags": {
"description": "Filter by hashtags",
"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",
"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",
"type": "string"
}
},
"type": "object"
}Example response
{
"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"
}