Desearch Twitter Posts Search - Datura Console API

POST

desearch

links

twitter

curl --request POST \
  --url https://apis.datura.ai/desearch/ai/search/links/twitter \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "What are the recent sport events?",
  "model": "NOVA"
}'

{
  "miner_tweets": [
    {
      "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,
      "entities": {},
      "summary_description": "This is a summary of the tweet."
    }
  ]
}

Authorizations

Authorization

string

header

required

Body

application/json

prompt

string

required

Search query prompt

Example:

"What are the recent sport events?"

model

enum<string>

default:NOVA

Model to use for scraping. Options: NOVA, ORBIT, HORIZON

Available options:

NOVA,

ORBIT,

HORIZON

Example:

"NOVA"

Response

200

application/json

A JSON object mapping Twitter Search to its search results.

miner_tweets

required

Miner tweets

miner_tweets.user

object

required

miner_tweets.id

string

required

Example:

"987654321"

miner_tweets.text

string

required

Example:

"This is an example tweet."

miner_tweets.url

string

required

Example:

"https://twitter.com/example_tweet"

miner_tweets.created_at

string

required

Example:

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

miner_tweets.media

any[]

required

Example:

[]

miner_tweets.entities

object

required

Example:

{}

miner_tweets.summary_description

string

required

Example:

"This is a summary of the tweet."

miner_tweets.reply_count

integer

Example:

10

miner_tweets.retweet_count

integer

Example:

5

miner_tweets.like_count

integer

Example:

100

miner_tweets.view_count

integer

Example:

1000

miner_tweets.quote_count

integer

Example:

2

miner_tweets.impression_count

integer

Example:

1500

miner_tweets.bookmark_count

integer

Example:

3

miner_tweets.is_quote_tweet

boolean

Example:

false

miner_tweets.is_retweet

boolean

Example:

false

Desearch Web Link Search Basic Twitter Search

curl --request POST \
  --url https://apis.datura.ai/desearch/ai/search/links/twitter \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "What are the recent sport events?",
  "model": "NOVA"
}'

{
  "miner_tweets": [
    {
      "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,
      "entities": {},
      "summary_description": "This is a summary of the tweet."
    }
  ]
}

API Reference

Authorizations

Body

Response