Desearch Х Posts Search
The Х Posts Search API allows users to search for relevant links based on Х search queries with leveraging AI-powered models. This API analyze links from Х posts that match the given prompt. This API is useful for tracking trends, gathering insights, and retrieving real-time information from Х.
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,
"is_blue_verified": true,
"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,
"lang": "en",
"conversation_id": "1892717639455109181",
"in_reply_to_screen_name": "null",
"in_reply_to_status_id": "null",
"in_reply_to_user_id": "null",
"quoted_status_id": "null",
"quote": "null",
"entities": {},
"summary_description": "This is a summary of the tweet."
}
]
}
Authorizations
Body
Search query prompt
"What are the recent sport events?"
Model to use for scraping. Options: NOVA, ORBIT, HORIZON
NOVA
, ORBIT
, HORIZON
"NOVA"
Response
Miner tweets
"123456789"
"johndoe"
"https://twitter.com/example_user"
"John Doe"
"2023-01-01T00:00:00Z"
"This is an example user description."
100
1500
10
50
"https://example.com/profile.jpg"
500
true
true
true
true
"Jamaica"
"987654321"
"This is an example tweet."
10
5
100
1000
2
1500
3
"https://twitter.com/example_tweet"
"2023-01-01T00:00:00Z"
[]
false
false
Language code (e.g., en, es, fr)
"en"
"1892717639455109181"
null
null
null
null
null
{}
"This is a summary of the tweet."
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,
"is_blue_verified": true,
"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,
"lang": "en",
"conversation_id": "1892717639455109181",
"in_reply_to_screen_name": "null",
"in_reply_to_status_id": "null",
"in_reply_to_user_id": "null",
"quoted_status_id": "null",
"quote": "null",
"entities": {},
"summary_description": "This is a summary of the tweet."
}
]
}