GET
$0.01 default
/api/search/tweetsDescription
Search for tweets by query (optional product filter; paginate with cursor). Example: GET /api/search/tweets?q=typescript
Pricing
$0.01 default
Parameters
{
"properties": {
"cursor": {
"description": "Pagination cursor from a previous response's pagination.next_cursor (the conversation endpoint at /api/{name}/tweets/{id} instead takes its own nested reply cursor — see that endpoint).",
"type": "string"
},
"product": {
"description": "Result ordering, e.g. Top or Latest.",
"type": "string"
},
"q": {
"description": "Tweet search query.",
"minLength": 1,
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
}Example response
{
"code": 0,
"data": {
"tweets": [
{
"attribution": null,
"available": true,
"card": null,
"hasThread": false,
"history": null,
"id": "22",
"isAI": false,
"isAd": false,
"location": "",
"media": null,
"mediaTags": null,
"note": null,
"pinned": false,
"poll": null,
"quote": null,
"reply": [],
"replyId": "0",
"retweet": null,
"source": "",
"stats": {
"likes": 42,
"quotes": 0,
"replies": 0,
"retweets": 0,
"views": 0
},
"text": "... typescript ...",
"threadId": "20",
"time": 1142974214,
"tombstone": "",
"user": {
"banner": "",
"bio": "",
"followers": 599,
"following": 307,
"fullname": "Someone",
"id": "99",
"joinDate": 1142974214,
"likes": 0,
"location": "",
"media": 0,
"pinnedTweet": "0",
"protected": false,
"suspended": false,
"tweets": 30000,
"userPic": "",
"username": "someone",
"verifiedType": "Blue",
"website": ""
}
}
]
},
"pagination": {
"has_more": true,
"next_cursor": "DAABCgABG...cursor"
}
}