GET
/
twitter
/
urls
curl --request GET \
  --url https://apis.datura.ai/twitter/urls \
  --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": "1892527552029499853",
    "text": "New episode of The Motorsport Recently Show now out on YouTube and Spotify...",
    "reply_count": 0,
    "retweet_count": 0,
    "like_count": 0,
    "quote_count": 0,
    "bookmark_count": 0,
    "url": "https://x.com/RacingTriple/status/1892527552029499853",
    "created_at": "Thu Feb 20 10:51:44 +0000 2025",
    "media": [],
    "is_quote_tweet": false,
    "is_retweet": false,
    "lang": "en",
    "conversation_id": "1892527552029499853",
    "in_reply_to_screen_name": "<string>",
    "in_reply_to_status_id": "<string>",
    "in_reply_to_user_id": "<string>",
    "quoted_status_id": "<string>",
    "quote": "<string>",
    "display_text_range": [
      0,
      166
    ],
    "entities": {
      "hashtags": [],
      "symbols": [],
      "timestamps": [],
      "urls": [
        {
          "display_url": "open.spotify.com/episode/6lW29d…",
          "expanded_url": "https://open.spotify.com/episode/6lW29dxjnWQPmSB5ilXnIi?si=a66a9c3b16bf41fe",
          "indices": [
            118,
            141
          ],
          "url": "https://t.co/N5oaoJRJx0"
        },
        {
          "display_url": "youtu.be/0V1qT7ALPEE",
          "expanded_url": "https://youtu.be/0V1qT7ALPEE",
          "indices": [
            143,
            166
          ],
          "url": "https://t.co/zdmk4zd13y"
        }
      ],
      "user_mentions": []
    },
    "extended_entities": {}
  }
]

Authorizations

​
Authorization
string
header
required

Query Parameters

​
urls
string[]
required

List of urls that is to be retrieved.

Response

200
application/json
A JSON object mapping tweet URLs to their details.
​
user
object
required
​
id
string
required

Unique identifier for the tweet.

Example:

"1892527552029499853"

​
text
string
required

The tweet's content.

Example:

"New episode of The Motorsport Recently Show now out on YouTube and Spotify..."

​
reply_count
integer
required

Number of replies to the tweet.

Example:

0

​
retweet_count
integer
required

Number of retweets.

Example:

0

​
like_count
integer
required

Number of likes the tweet has received.

Example:

0

​
quote_count
integer
required

Number of times the tweet has been quoted.

Example:

0

​
bookmark_count
integer
required

Number of bookmarks on the tweet.

Example:

0

​
url
string
required

Direct URL to the tweet.

Required string length: 1 - 2083
Example:

"https://x.com/RacingTriple/status/1892527552029499853"

​
created_at
string
required

Timestamp of when the tweet was created.

Example:

"Thu Feb 20 10:51:44 +0000 2025"

​
is_quote_tweet
boolean
required

Indicates if the tweet is a quoted tweet.

Example:

false

​
is_retweet
boolean
required

Indicates if the tweet is a retweet.

Example:

false

​
lang
string
required

Language code of the tweet.

Example:

"en"

​
conversation_id
string
required

ID of the conversation thread the tweet belongs to.

Example:

"1892527552029499853"

​
in_reply_to_screen_name
string | null
required

Screen name of the user this tweet is replying to (if applicable).

​
in_reply_to_status_id
string | null
required

ID of the tweet being replied to (if applicable).

​
in_reply_to_user_id
string | null
required

User ID of the tweet author being replied to (if applicable).

​
quoted_status_id
string | null
required

ID of the tweet that was quoted (if applicable).

​
quote
string | null
required

Quoted text from another tweet (if applicable).

​
display_text_range
integer[]
required

Character range in the tweet where text is displayed.

Example:
[0, 166]
​
entities
object
required

Metadata about hashtags, mentions, links, and other entities within the tweet.

​
media
any[]

List of media attachments, if any.

Example:
[]
​
extended_entities
object

Extended metadata about media attachments.

Example:
{}