Skip to main content
GET
/
x
/
search
curl -X GET "https://scrape.st/x/search?q=bitcoin&count=20" \
  -H "x-api-key: YOUR_API_KEY"

{
  "posts": [
    {
      "id": "1886493083207827456",
      "text": "Bitcoin hits new all-time high! 🚀",
      "created_at": "2024-04-02T15:30:00.000Z",
      "lang": "en",
      "favorite_count": 15000,
      "retweet_count": 3000,
      "reply_count": 800,
      "quote_count": 400,
      "bookmark_count": 1200,
      "author": {
        "id": "44196397",
        "name": "Elon Musk",
        "screen_name": "elonmusk",
        "profile_image_url": "https://pbs.twimg.com/profile_images/xxx/elonmusk_normal.jpg",
        "verified": true,
        "is_blue_verified": true
      },
      "link": "https://x.com/elonmusk/status/1886493083207827456"
    }
  ],
  "nextCursor": "DAABCgAB..."
}
Search for posts on X matching a query string with pagination support.

​
Query Parameters

​
q
string
required
Search query string (1-1000 characters)
​
count
number
default:"20"
Number of results to return (1-50)
​
cursor
string
Pagination cursor for fetching next page

​
Response

​
posts
array
Array of post objects
​
nextCursor
string
Cursor for fetching the next page of results
curl -X GET "https://scrape.st/x/search?q=bitcoin&count=20" \
  -H "x-api-key: YOUR_API_KEY"

{
  "posts": [
    {
      "id": "1886493083207827456",
      "text": "Bitcoin hits new all-time high! 🚀",
      "created_at": "2024-04-02T15:30:00.000Z",
      "lang": "en",
      "favorite_count": 15000,
      "retweet_count": 3000,
      "reply_count": 800,
      "quote_count": 400,
      "bookmark_count": 1200,
      "author": {
        "id": "44196397",
        "name": "Elon Musk",
        "screen_name": "elonmusk",
        "profile_image_url": "https://pbs.twimg.com/profile_images/xxx/elonmusk_normal.jpg",
        "verified": true,
        "is_blue_verified": true
      },
      "link": "https://x.com/elonmusk/status/1886493083207827456"
    }
  ],
  "nextCursor": "DAABCgAB..."
}