GET/v1/twitter/search
Search tweets
Search tweets on X (Twitter) using any query syntax — keywords, `from:username`, `-filter:replies`, hashtags, and more. Returns paginated tweet results with full author and engagement data.
Parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | X search query. Supports operators like `from:username`, `-filter:replies`, `#hashtag` e.g. from:airaaagent -filter:replies |
| type | string | Sort order — `Latest` for chronological, `Top` for most relevant/popular e.g. Latest default: Latest LatestTop |
| cursor | string | Pagination cursor from previous response (`pagination_info.cursor`) |
Request
Shell
curl -G "https://social-api.airaa.xyz/v1/twitter/search" \ -H "X-API-KEY: YOUR_KEY" \ -d "query=from:airaaagent -filter:replies" \ -d "type=Latest"
Try it
Live requestRuns against the real API
X-API-KEY
queryrequired
type
cursor
Response example
200 OKapplication/json
{
"data": [
{
"id": "2056345365578924426",
"conversationId": "2056345365578924426",
"text": "MWX Community is live on Airaa 🌸\n\nJoin MWX's community and complete social tasks to earn $USDC, with more campaigns coming soon!\n\nJoin here: https://app.airaa.xyz/community/mwx",
"author": {
"id": "1879958545535291392",
"username": "AiraaAgent",
"name": "Airaa HQ 🌸",
"bio": "A unified distribution platform for brands to go viral.",
"avatar": "https://pbs.twimg.com/profile_images/2024763937083076608/fZtHCduJ_normal.jpg",
"verified": false,
"isBlueVerified": true,
"followerCount": 13128,
"followingCount": 70,
"tweetCount": 2401,
"createdAt": "2025-01-16T18:27:09.000Z"
},
"source": "Twitter Web App",
"type": "tweet"
}
],
"pagination_info": {
"cursor": "DAABCgABGX8f9k2N..."
}
}Response codes
200Tweet search results
400Missing or invalid query parameter
401Missing or invalid `X-API-KEY` header
429Request quota exceeded — contact light@airaa.xyz to upgrade your plan
500Server misconfiguration — API key environment variable not set
502Airaa service temporarily unavailable — please try again
504Request timed out — please try again
All error responses follow the shape
{ "error": "message" }