GET/v1/twitter/search
Search posts
Search posts on X (Twitter) using any query syntax — keywords, `from:username`, `-filter:replies`, hashtags, and more.
Engagement counts are grouped under `metrics`. `hashtags`, `mentions`, and `urls` are always present (possibly empty). `reply_to`, `quoted_post`, and `reposted_post` appear only on replies, quotes, and reposts respectively.
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 the previous response (`pagination.next_cursor`) |
Request
Shell
curl -G "https://socialapi.airaa.xyz/v1/twitter/search" \ -H "X-API-KEY: YOUR_KEY" \ -d "query=from:AiraaAgent -filter:replies" \ -d "type=Latest"
Try it
Live requestRelayed through this site — your key is never stored
X-API-KEY
queryrequired
type
cursor
Response example
200 OKapplication/json
{
"posts": [
{
"id": "2089783163388338274",
"post_url": "https://x.com/AiraaAgent/status/2089783163388338274",
"type": "post",
"text": "1Win is onboarding creators on Airaa.\n\nif you create content around gaming, betting or crypto, this one is for you.",
"display_text_range": {
"start": 0,
"end": 225
},
"published_at": "2026-08-18T18:35:07.000Z",
"conversation_id": "2089783163388338274",
"author": {
"id": "1879958545535291392",
"username": "AiraaAgent",
"name": "Airaa HQ 🌸",
"profile_url": "https://x.com/AiraaAgent",
"profile_picture_url": "https://pbs.twimg.com/profile_images/2024763937083076608/fZtHCduJ_normal.jpg",
"is_verified": false,
"is_blue_verified": true,
"is_private": false
},
"metrics": {
"like_count": 129,
"repost_count": 17,
"reply_count": 36,
"quote_count": 53,
"bookmark_count": 38,
"view_count": 21727
},
"media": [
{
"type": "image",
"url": "https://pbs.twimg.com/media/HQBmq2GasAAV5SE.jpg",
"thumbnail_url": "https://pbs.twimg.com/media/HQBmq2GasAAV5SE.jpg",
"width": 1672,
"height": 941,
"duration_seconds": null,
"alt_text": null
}
],
"hashtags": [],
"mentions": [],
"urls": []
}
],
"pagination": {
"next_cursor": "DAADDAABCgABHQBmtwdaoGIKAAIcR-rt_RohdwAIAAIAAAACCAAD",
"previous_cursor": "DAADDAABCgABHQBmtwdaoGIKAAIcR-rt_RohdwAIAAIAAAABCAAD"
}
}Response codes
200Post 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
502Upstream provider temporarily unavailable — please try again
504Request timed out — please try again
All error responses follow the shape
{ "error": "message" }