GET
/
twitter
curl --request GET \
  --url https://apis.datura.ai/twitter \
  --header 'Authorization: <api-key>'
[
  {
    "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,
      "is_blue_verified": true,
      "entities": {},
      "can_dm": true,
      "can_media_tag": true,
      "location": "Jamaica"
    },
    "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

Query Parameters

​
query
string
required

Search query. For syntax, check https://docs.datura.ai/guides/capabilities/twitter-queries

​
sort
string | null

Sort by Top or Latest

​
user
string | null

User to search for

​
start_date
string | null

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

​
end_date
string | null

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

​
lang
string | null

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

​
verified
boolean | null

Filter for verified users

​
blue_verified
boolean | null

Filter for blue checkmark verified users

​
is_quote
boolean | null

Include only tweets with quotes

​
is_video
boolean | null

Include only tweets with videos

​
is_image
boolean | null

Include only tweets with images

​
min_retweets

Minimum number of retweets

​
min_replies

Minimum number of replies

​
min_likes

Minimum number of likes

​
count
integer | null
default:20

Number of tweets to retrieve

Required range: 1 <= x <= 100

Response

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

"987654321"

​
text
string | null
required
Example:

"This is an example tweet."

​
reply_count
integer | null
required
Example:

10

​
retweet_count
integer | null
required
Example:

5

​
like_count
integer | null
required
Example:

100

​
view_count
integer | null
required
Example:

1000

​
quote_count
integer | null
required
Example:

2

​
impression_count
integer | null
required
Example:

1500

​
bookmark_count
integer | null
required
Example:

3

​
url
string | null
required
Example:

"https://twitter.com/example_tweet"

​
created_at
string | null
required
Example:

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

​
is_quote_tweet
boolean | null
required
Example:

false

​
is_retweet
boolean | null
required
Example:

false

​
media
object[] | null
Example:
[]