POST
/
twitter
curl --request POST \
  --url https://apis.datura.ai/twitter \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "from:elonmusk #AI since:2023-01-01 until:2023-12-31",
  "sort": "Top",
  "user": "elonmusk",
  "start_date": "2025-01-01",
  "end_date": "2025-01-30",
  "lang": "en",
  "verified": true,
  "blue_verified": true,
  "is_quote": true,
  "is_video": true,
  "is_image": true,
  "min_retweets": 1,
  "min_replies": 1,
  "min_likes": 1
}'
[
  {
    "user": {
      "id": "123456789",
      "url": "https://twitter.com/example_user",
      "name": "John Doe",
      "username": "johndoe",
      "created_at": "2023-01-01T00:00:00Z",
      "description": "This is an example user description.",
      "favourites_count": 100,
      "followers_count": 1500,
      "listed_count": 10,
      "media_count": 50,
      "profile_image_url": "https://example.com/profile.jpg",
      "statuses_count": 500,
      "verified": true
    },
    "id": "987654321",
    "text": "This is an example tweet.",
    "reply_count": 10,
    "retweet_count": 5,
    "like_count": 100,
    "view_count": 1000,
    "quote_count": 2,
    "impression_count": 1500,
    "bookmark_count": 3,
    "url": "https://twitter.com/example_tweet",
    "created_at": "2023-01-01T00:00:00Z",
    "media": [],
    "is_quote_tweet": false,
    "is_retweet": false
  }
]

Authorizations

​
Authorization
string
header
required

Body

application/json
​
query
string
required

Search query. For syntax, check https://github.com/igorbrigadir/twitter-advanced-search

Example:

"from:elonmusk #AI since:2023-01-01 until:2023-12-31"

​
sort
string

Sort by Top or Latest

Example:

"Top"

​
user
string

User to search for

Example:

"elonmusk"

​
start_date
string

Start date in UTC (YYYY-MM-DD format)

Example:

"2025-01-01"

​
end_date
string

End date in UTC (YYYY-MM-DD format)

Example:

"2025-01-30"

​
lang
string

Language code (e.g., en, es, fr)

Example:

"en"

​
verified
boolean

Filter for verified users

Example:

true

​
blue_verified
boolean

Filter for blue checkmark verified users

Example:

true

​
is_quote
boolean

Include only tweets with quotes

Example:

true

​
is_video
boolean

Include only tweets with videos

Example:

true

​
is_image
boolean

Include only tweets with images

Example:

true

​
min_retweets

Minimum number of retweets

Example:

1

​
min_replies

Minimum number of replies

Example:

1

​
min_likes

Minimum number of likes

Example:

1

Response

200
application/json
A JSON object mapping Twitter Search to its search results.
​
user
object
​
id
string
Example:

"987654321"

​
text
string
Example:

"This is an example tweet."

​
reply_count
integer
Example:

10

​
retweet_count
integer
Example:

5

​
like_count
integer
Example:

100

​
view_count
integer
Example:

1000

​
quote_count
integer
Example:

2

​
impression_count
integer
Example:

1500

​
bookmark_count
integer
Example:

3

​
url
string
Example:

"https://twitter.com/example_tweet"

​
created_at
string
Example:

"2023-01-01T00:00:00Z"

​
media
object[]
Example:
[]
​
is_quote_tweet
boolean
Example:

false

​
is_retweet
boolean
Example:

false

Desearch Twitter Posts SearchBasic Web Search (Coming Soon)