Skip to main content
GET
/
search
/
tweets
Search Tweets
curl --request GET \
  --url https://api.zilodata.com/api/v1/x/search/tweets \
  --header 'Authorization: Bearer <token>'
{
  "tweets": [
    {
      "id": "1234567890123456789",
      "text": "Just launched a new product! Check it out #innovation",
      "author": "elonmusk",
      "likeCount": 50000,
      "retweetCount": 10000,
      "replyCount": 2000,
      "quoteCount": 500,
      "viewCount": 1000000,
      "createdAt": "2025-01-15T10:30:00.000Z",
      "isRetweet": false,
      "retweetedTweet": "<unknown>",
      "url": "https://twitter.com/elonmusk/status/1234567890123456789",
      "media": [
        {
          "type": "photo",
          "url": "<string>"
        }
      ]
    }
  ],
  "total": 123
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

query
string
required

Search query (supports operators like #hashtag, @mention, etc.)

limit
integer
default:20
since
string<date-time>

Get tweets after this date (ISO 8601)

until
string<date-time>

Get tweets before this date (ISO 8601)

Response

200 - application/json

Successful response

tweets
object[]
total
integer