Search
curl --request GET \
--url https://api.sociavault.com/v1/scrape/twitter/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/twitter/search"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/twitter/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/twitter/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/twitter/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/twitter/search")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/twitter/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"error": false,
"cursor": {
"bottom": "DAACCgACHPoex7FAJxAKAAMc-h7HsT_Y8AgABAAAAAILAAUAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRYytkZVBoRmJBNWh6NkNIcksya0FWSFBqbStJcWFzR01jOUl0d1lCZXdYaHo2RGlNMGw3RFVIUG5kMUd1V0lad2M5MkJZdEZ2UmNCejUzWVpLMmhBdkhQbWpKRVFYSUdVYzhqOWd6aGRnQ0J6NkIrRjFGNUZwSFBhZEhvMGE4UThjK1p4WCtGcnd1Qno1KytiZzFxRy9IUG00dGdqV1FKRWM5SXNFSVZaQWZoejU2SXlIVjJIT0hQbkdnM2FYMFJjYytYTWt1WnR3dlJ6dzFqQ3dWbEJJCAAGAAAAAAgABwAAAAAMAAgKAAEc8NYwsFZQSAAAAA",
"top": "DAACCgACHPoex7FAJxAKAAMc-h7HsT_Y8AgABAAAAAELAAUAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRYytkZVBoRmJBNWh6NkNIcksya0FWSFBqbStJcWFzR01jOUl0d1lCZXdYaHo2RGlNMGw3RFVIUG5kMUd1V0lad2M5MkJZdEZ2UmNCejUzWVpLMmhBdkhQbWpKRVFYSUdVYzhqOWd6aGRnQ0J6NkIrRjFGNUZwSFBhZEhvMGE4UThjK1p4WCtGcnd1Qno1KytiZzFxRy9IUG00dGdqV1FKRWM5SXNFSVZaQWZoejU2SXlIVjJIT0hQbkdnM2FYMFJjYytYTWt1WnR3dlJ6dzFqQ3dWbEJJCAAGAAAAAAgABwAAAAAMAAgKAAEc8NYwsFZQSAAAAA"
},
"result": {
"timeline": {
"instructions": [
{
"entries": [
{
"content": {
"__typename": "TimelineTimelineItem",
"clientEventInfo": {
"component": "result",
"details": {
"timelinesDetails": {
"controllerData": "DAACDAAFDAABDAABDAABCgABAAAAAgACAAAAAAwAAgoAAQAAAAAAAAABCgAC+ELhsGrQNBsLAAMAAAAHYml0Y29pbgoABRqkE5BWnflTCAAGAAAAAQoAByvFVhCRM6XfCgAIAAABn/0IIWwAAAAAAA=="
}
},
"element": "tweet"
},
"entryType": "TimelineTimelineItem",
"feedbackInfo": {
"feedbackKeys": [
"-2134788070"
]
},
"itemContent": {
"__typename": "TimelineTweet",
"highlights": {
"textHighlights": [
{
"endIndex": 71,
"startIndex": 64
}
]
},
"itemType": "TimelineTweet",
"tweetDisplayType": "Tweet",
"tweet_results": {
"result": {
"__typename": "Tweet",
"core": {
"user_results": {
"result": {
"__typename": "User",
"affiliates_highlighted_label": {},
"has_graduated_access": true,
"id": "VXNlcjoxMzcyNTY4MTg3MTM3NjM0MzEy",
"is_blue_verified": true,
"legacy": {
"blocked_by": false,
"blocking": false,
"can_dm": true,
"can_media_tag": true,
"created_at": "Thu Mar 18 15:19:45 +0000 2021",
"default_profile": true,
"default_profile_image": false,
"description": "Explicando #Bitcoin e ajudando investidores a construir patrimônio com dinheiro descentralizado. \nHead Research @formadores_edu, Embaixador @InsilicoTrading.",
"entities": {
"description": {},
"url": {
"urls": [
{
"display_url": "linktr.ee/caueconomy",
"expanded_url": "https://linktr.ee/caueconomy",
"indices": [
0,
23
],
"url": "https://t.co/7k4skWu6xI"
}
]
}
},
"fast_followers_count": 0,
"favourites_count": 47342,
"follow_request_sent": false,
"followed_by": false,
"followers_count": 32745,
"following": false,
"friends_count": 1581,
"has_custom_timelines": true,
"is_translator": false,
"listed_count": 351,
"location": "",
"media_count": 7148,
"muting": false,
"name": "Cauê Oliveira",
"needs_phone_verification": false,
"normal_followers_count": 32745,
"notifications": false,
"possibly_sensitive": false,
"profile_banner_url": "https://pbs.twimg.com/profile_banners/1372568187137634312/1750153422",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/1440970906923376642/6M-gRDjG_normal.jpg",
"profile_interstitial_type": "",
"protected": false,
"screen_name": "caueconomy",
"statuses_count": 22144,
"time_zone": "",
"translator_type": "none",
"url": "https://t.co/7k4skWu6xI",
"utc_offset": 0,
"verified": false,
"want_retweets": false,
"withheld_description": "",
"withheld_scope": ""
},
"professional": {
"category": [],
"professional_type": "Creator",
"rest_id": "1502245534899355653"
},
"profile_image_shape": "Circle",
"rest_id": "1372568187137634312",
"super_follow_eligible": false,
"super_followed_by": false,
"super_following": false,
"tipjar_settings": {
"bitcoin_handle": "3JojAaytVMsrTbGTa2wG2W8e2TE2YqNL7v",
"is_enabled": true
}
}
}
},
"edit_control": {
"edit_tweet_ids": [
"2087955592526651854"
],
"editable_until_msecs": "1786645980000",
"edits_remaining": "5",
"is_edit_eligible": true
},
"is_translatable": true,
"legacy": {
"bookmark_count": 12,
"bookmarked": false,
"conversation_id_str": "2087955592526651854",
"created_at": "Thu Aug 13 17:33:00 +0000 2026",
"display_text_range": [
0,
279
],
"entities": {
"media": [
{
"allow_download_status": {
"allow_download": true
},
"display_url": "pic.x.com/fwErZlcTQO",
"expanded_url": "https://x.com/caueconomy/status/2087955592526651854/photo/1",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": []
},
"medium": {
"faces": []
},
"orig": {
"faces": []
},
"small": {
"faces": []
}
},
"id_str": "2087933519326560257",
"indices": [
280,
303
],
"media_key": "3_2087933519326560257",
"media_results": {
"result": {
"media_key": "3_2087933519326560257"
}
},
"media_url_https": "https://pbs.twimg.com/media/HPnUeTYXQAE2fzq.jpg",
"original_info": {
"focus_rects": [
{
"h": 634,
"w": 1132,
"x": 0,
"y": 188
},
{
"h": 822,
"w": 822,
"x": 155,
"y": 0
},
{
"h": 822,
"w": 721,
"x": 206,
"y": 0
},
{
"h": 822,
"w": 411,
"x": 361,
"y": 0
},
{
"h": 822,
"w": 1132,
"x": 0,
"y": 0
}
],
"height": 822,
"width": 1132
},
"sizes": {
"large": {
"h": 822,
"resize": "fit",
"w": 1132
},
"medium": {
"h": 822,
"resize": "fit",
"w": 1132
},
"small": {
"h": 494,
"resize": "fit",
"w": 680
},
"thumb": {
"h": 150,
"resize": "crop",
"w": 150
}
},
"type": "photo",
"url": "https://t.co/fwErZlcTQO"
}
]
},
"extended_entities": {
"media": [
{
"allow_download_status": {
"allow_download": true
},
"display_url": "pic.x.com/fwErZlcTQO",
"expanded_url": "https://x.com/caueconomy/status/2087955592526651854/photo/1",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": []
},
"medium": {
"faces": []
},
"orig": {
"faces": []
},
"small": {
"faces": []
}
},
"id_str": "2087933519326560257",
"indices": [
280,
303
],
"media_key": "3_2087933519326560257",
"media_results": {
"result": {
"media_key": "3_2087933519326560257"
}
},
"media_url_https": "https://pbs.twimg.com/media/HPnUeTYXQAE2fzq.jpg",
"original_info": {
"focus_rects": [
{
"h": 634,
"w": 1132,
"x": 0,
"y": 188
},
{
"h": 822,
"w": 822,
"x": 155,
"y": 0
},
{
"h": 822,
"w": 721,
"x": 206,
"y": 0
},
{
"h": 822,
"w": 411,
"x": 361,
"y": 0
},
{
"h": 822,
"w": 1132,
"x": 0,
"y": 0
}
],
"height": 822,
"width": 1132
},
"sizes": {
"large": {
"h": 822,
"resize": "fit",
"w": 1132
},
"medium": {
"h": 822,
"resize": "fit",
"w": 1132
},
"small": {
"h": 494,
"resize": "fit",
"w": 680
},
"thumb": {
"h": 150,
"resize": "crop",
"w": 150
}
},
"type": "photo",
"url": "https://t.co/fwErZlcTQO"
}
]
},
"favorite_count": 150,
"favorited": false,
"full_text": "Alguém pagou 1,6 BTC ($102 mil) em taxa para não enviar nada de bitcoin.🚨\n\nA transação \"comeu\" todo o saldo da transação fazendo com que essa tenha sido uma transação que pagou 39 MIL VEZES de excesso.\n\nA causa foi um bug no RBF (Replace-by-Fee) ativado, aumentando a fee sozinho https://t.co/fwErZlcTQO",
"id_str": "2087955592526651854",
"is_quote_status": false,
"lang": "pt",
"possibly_sensitive": false,
"possibly_sensitive_editable": true,
"quote_count": 5,
"reply_count": 23,
"retweet_count": 8,
"retweeted": false,
"user_id_str": "1372568187137634312"
},
"note_tweet": {
"is_expandable": true,
"note_tweet_results": {
"result": {
"entity_set": {
"hashtags": [],
"symbols": [],
"urls": [],
"user_mentions": []
},
"id": "Tm90ZVR3ZWV0OjIwODc5NTU1OTI0NTk1MzAyNDA=",
"richtext": {
"richtext_tags": [
{
"from_index": 0,
"richtext_types": [
"Bold"
],
"to_index": 74
}
]
},
"text": "Alguém pagou 1,6 BTC ($102 mil) em taxa para não enviar nada de bitcoin.🚨\n\nA transação \"comeu\" todo o saldo da transação fazendo com que essa tenha sido uma transação que pagou 39 MIL VEZES de excesso.\n\nA causa foi um bug no RBF (Replace-by-Fee) ativado, aumentando a fee sozinho a cada tentativa por cerca de 29 minutos direto, até devorar os 1,6 BTC inteiros da carteira.\n\nUm dos erros mais caros que já vi na rede."
}
}
},
"rest_id": "2087955592526651854",
"source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter Web Client</a>",
"unmention_data": {},
"views": {
"count": "10051",
"state": "EnabledWithCount"
}
}
}
}
},
"entryId": "tweet-2087955592526651854",
"sortIndex": "2088015220260732928"
}
],
"type": "TimelineAddEntries"
}
],
"responseObjects": {
"feedbackActions": [
{
"key": "-2134788070",
"value": {
"childKeys": [
"269351462",
"-1399782652"
],
"clientEventInfo": {
"action": "click",
"component": "result",
"element": "feedback_givefeedback"
},
"confirmation": "Thanks for offering your feedback. X is conducting research to improve search. Choose the option that best reflects your opinion.",
"confirmationDisplayType": "Inline",
"feedbackType": "GiveFeedback",
"hasUndoAction": true,
"icon": "Frown",
"prompt": "This post's not helpful"
}
},
{
"key": "269351462",
"value": {
"clientEventInfo": {
"action": "click",
"component": "result",
"element": "feedback_notrelevant"
},
"confirmation": "Thanks for your help.\nThis feedback will be used in research to improve the search function.",
"confirmationDisplayType": "Inline",
"feedbackType": "NotRelevant",
"hasUndoAction": true,
"prompt": "This post isn't relevant"
}
}
]
}
}
}
},
"result_count": 20,
"has_more": true,
"credits_used": 1,
"endpoint": "twitter/search"
}{
"error": "query is required",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Failed to search Twitter",
"endpoint": "search"
}Twitter
Search
Search Twitter for tweets, users, photos, media, and more. Results are paginated — use the cursor parameter to fetch additional pages.
GET
/
v1
/
scrape
/
twitter
/
search
Search
curl --request GET \
--url https://api.sociavault.com/v1/scrape/twitter/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/twitter/search"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/twitter/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/twitter/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/twitter/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/twitter/search")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/twitter/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"error": false,
"cursor": {
"bottom": "DAACCgACHPoex7FAJxAKAAMc-h7HsT_Y8AgABAAAAAILAAUAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRYytkZVBoRmJBNWh6NkNIcksya0FWSFBqbStJcWFzR01jOUl0d1lCZXdYaHo2RGlNMGw3RFVIUG5kMUd1V0lad2M5MkJZdEZ2UmNCejUzWVpLMmhBdkhQbWpKRVFYSUdVYzhqOWd6aGRnQ0J6NkIrRjFGNUZwSFBhZEhvMGE4UThjK1p4WCtGcnd1Qno1KytiZzFxRy9IUG00dGdqV1FKRWM5SXNFSVZaQWZoejU2SXlIVjJIT0hQbkdnM2FYMFJjYytYTWt1WnR3dlJ6dzFqQ3dWbEJJCAAGAAAAAAgABwAAAAAMAAgKAAEc8NYwsFZQSAAAAA",
"top": "DAACCgACHPoex7FAJxAKAAMc-h7HsT_Y8AgABAAAAAELAAUAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRYytkZVBoRmJBNWh6NkNIcksya0FWSFBqbStJcWFzR01jOUl0d1lCZXdYaHo2RGlNMGw3RFVIUG5kMUd1V0lad2M5MkJZdEZ2UmNCejUzWVpLMmhBdkhQbWpKRVFYSUdVYzhqOWd6aGRnQ0J6NkIrRjFGNUZwSFBhZEhvMGE4UThjK1p4WCtGcnd1Qno1KytiZzFxRy9IUG00dGdqV1FKRWM5SXNFSVZaQWZoejU2SXlIVjJIT0hQbkdnM2FYMFJjYytYTWt1WnR3dlJ6dzFqQ3dWbEJJCAAGAAAAAAgABwAAAAAMAAgKAAEc8NYwsFZQSAAAAA"
},
"result": {
"timeline": {
"instructions": [
{
"entries": [
{
"content": {
"__typename": "TimelineTimelineItem",
"clientEventInfo": {
"component": "result",
"details": {
"timelinesDetails": {
"controllerData": "DAACDAAFDAABDAABDAABCgABAAAAAgACAAAAAAwAAgoAAQAAAAAAAAABCgAC+ELhsGrQNBsLAAMAAAAHYml0Y29pbgoABRqkE5BWnflTCAAGAAAAAQoAByvFVhCRM6XfCgAIAAABn/0IIWwAAAAAAA=="
}
},
"element": "tweet"
},
"entryType": "TimelineTimelineItem",
"feedbackInfo": {
"feedbackKeys": [
"-2134788070"
]
},
"itemContent": {
"__typename": "TimelineTweet",
"highlights": {
"textHighlights": [
{
"endIndex": 71,
"startIndex": 64
}
]
},
"itemType": "TimelineTweet",
"tweetDisplayType": "Tweet",
"tweet_results": {
"result": {
"__typename": "Tweet",
"core": {
"user_results": {
"result": {
"__typename": "User",
"affiliates_highlighted_label": {},
"has_graduated_access": true,
"id": "VXNlcjoxMzcyNTY4MTg3MTM3NjM0MzEy",
"is_blue_verified": true,
"legacy": {
"blocked_by": false,
"blocking": false,
"can_dm": true,
"can_media_tag": true,
"created_at": "Thu Mar 18 15:19:45 +0000 2021",
"default_profile": true,
"default_profile_image": false,
"description": "Explicando #Bitcoin e ajudando investidores a construir patrimônio com dinheiro descentralizado. \nHead Research @formadores_edu, Embaixador @InsilicoTrading.",
"entities": {
"description": {},
"url": {
"urls": [
{
"display_url": "linktr.ee/caueconomy",
"expanded_url": "https://linktr.ee/caueconomy",
"indices": [
0,
23
],
"url": "https://t.co/7k4skWu6xI"
}
]
}
},
"fast_followers_count": 0,
"favourites_count": 47342,
"follow_request_sent": false,
"followed_by": false,
"followers_count": 32745,
"following": false,
"friends_count": 1581,
"has_custom_timelines": true,
"is_translator": false,
"listed_count": 351,
"location": "",
"media_count": 7148,
"muting": false,
"name": "Cauê Oliveira",
"needs_phone_verification": false,
"normal_followers_count": 32745,
"notifications": false,
"possibly_sensitive": false,
"profile_banner_url": "https://pbs.twimg.com/profile_banners/1372568187137634312/1750153422",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/1440970906923376642/6M-gRDjG_normal.jpg",
"profile_interstitial_type": "",
"protected": false,
"screen_name": "caueconomy",
"statuses_count": 22144,
"time_zone": "",
"translator_type": "none",
"url": "https://t.co/7k4skWu6xI",
"utc_offset": 0,
"verified": false,
"want_retweets": false,
"withheld_description": "",
"withheld_scope": ""
},
"professional": {
"category": [],
"professional_type": "Creator",
"rest_id": "1502245534899355653"
},
"profile_image_shape": "Circle",
"rest_id": "1372568187137634312",
"super_follow_eligible": false,
"super_followed_by": false,
"super_following": false,
"tipjar_settings": {
"bitcoin_handle": "3JojAaytVMsrTbGTa2wG2W8e2TE2YqNL7v",
"is_enabled": true
}
}
}
},
"edit_control": {
"edit_tweet_ids": [
"2087955592526651854"
],
"editable_until_msecs": "1786645980000",
"edits_remaining": "5",
"is_edit_eligible": true
},
"is_translatable": true,
"legacy": {
"bookmark_count": 12,
"bookmarked": false,
"conversation_id_str": "2087955592526651854",
"created_at": "Thu Aug 13 17:33:00 +0000 2026",
"display_text_range": [
0,
279
],
"entities": {
"media": [
{
"allow_download_status": {
"allow_download": true
},
"display_url": "pic.x.com/fwErZlcTQO",
"expanded_url": "https://x.com/caueconomy/status/2087955592526651854/photo/1",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": []
},
"medium": {
"faces": []
},
"orig": {
"faces": []
},
"small": {
"faces": []
}
},
"id_str": "2087933519326560257",
"indices": [
280,
303
],
"media_key": "3_2087933519326560257",
"media_results": {
"result": {
"media_key": "3_2087933519326560257"
}
},
"media_url_https": "https://pbs.twimg.com/media/HPnUeTYXQAE2fzq.jpg",
"original_info": {
"focus_rects": [
{
"h": 634,
"w": 1132,
"x": 0,
"y": 188
},
{
"h": 822,
"w": 822,
"x": 155,
"y": 0
},
{
"h": 822,
"w": 721,
"x": 206,
"y": 0
},
{
"h": 822,
"w": 411,
"x": 361,
"y": 0
},
{
"h": 822,
"w": 1132,
"x": 0,
"y": 0
}
],
"height": 822,
"width": 1132
},
"sizes": {
"large": {
"h": 822,
"resize": "fit",
"w": 1132
},
"medium": {
"h": 822,
"resize": "fit",
"w": 1132
},
"small": {
"h": 494,
"resize": "fit",
"w": 680
},
"thumb": {
"h": 150,
"resize": "crop",
"w": 150
}
},
"type": "photo",
"url": "https://t.co/fwErZlcTQO"
}
]
},
"extended_entities": {
"media": [
{
"allow_download_status": {
"allow_download": true
},
"display_url": "pic.x.com/fwErZlcTQO",
"expanded_url": "https://x.com/caueconomy/status/2087955592526651854/photo/1",
"ext_media_availability": {
"status": "Available"
},
"features": {
"large": {
"faces": []
},
"medium": {
"faces": []
},
"orig": {
"faces": []
},
"small": {
"faces": []
}
},
"id_str": "2087933519326560257",
"indices": [
280,
303
],
"media_key": "3_2087933519326560257",
"media_results": {
"result": {
"media_key": "3_2087933519326560257"
}
},
"media_url_https": "https://pbs.twimg.com/media/HPnUeTYXQAE2fzq.jpg",
"original_info": {
"focus_rects": [
{
"h": 634,
"w": 1132,
"x": 0,
"y": 188
},
{
"h": 822,
"w": 822,
"x": 155,
"y": 0
},
{
"h": 822,
"w": 721,
"x": 206,
"y": 0
},
{
"h": 822,
"w": 411,
"x": 361,
"y": 0
},
{
"h": 822,
"w": 1132,
"x": 0,
"y": 0
}
],
"height": 822,
"width": 1132
},
"sizes": {
"large": {
"h": 822,
"resize": "fit",
"w": 1132
},
"medium": {
"h": 822,
"resize": "fit",
"w": 1132
},
"small": {
"h": 494,
"resize": "fit",
"w": 680
},
"thumb": {
"h": 150,
"resize": "crop",
"w": 150
}
},
"type": "photo",
"url": "https://t.co/fwErZlcTQO"
}
]
},
"favorite_count": 150,
"favorited": false,
"full_text": "Alguém pagou 1,6 BTC ($102 mil) em taxa para não enviar nada de bitcoin.🚨\n\nA transação \"comeu\" todo o saldo da transação fazendo com que essa tenha sido uma transação que pagou 39 MIL VEZES de excesso.\n\nA causa foi um bug no RBF (Replace-by-Fee) ativado, aumentando a fee sozinho https://t.co/fwErZlcTQO",
"id_str": "2087955592526651854",
"is_quote_status": false,
"lang": "pt",
"possibly_sensitive": false,
"possibly_sensitive_editable": true,
"quote_count": 5,
"reply_count": 23,
"retweet_count": 8,
"retweeted": false,
"user_id_str": "1372568187137634312"
},
"note_tweet": {
"is_expandable": true,
"note_tweet_results": {
"result": {
"entity_set": {
"hashtags": [],
"symbols": [],
"urls": [],
"user_mentions": []
},
"id": "Tm90ZVR3ZWV0OjIwODc5NTU1OTI0NTk1MzAyNDA=",
"richtext": {
"richtext_tags": [
{
"from_index": 0,
"richtext_types": [
"Bold"
],
"to_index": 74
}
]
},
"text": "Alguém pagou 1,6 BTC ($102 mil) em taxa para não enviar nada de bitcoin.🚨\n\nA transação \"comeu\" todo o saldo da transação fazendo com que essa tenha sido uma transação que pagou 39 MIL VEZES de excesso.\n\nA causa foi um bug no RBF (Replace-by-Fee) ativado, aumentando a fee sozinho a cada tentativa por cerca de 29 minutos direto, até devorar os 1,6 BTC inteiros da carteira.\n\nUm dos erros mais caros que já vi na rede."
}
}
},
"rest_id": "2087955592526651854",
"source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter Web Client</a>",
"unmention_data": {},
"views": {
"count": "10051",
"state": "EnabledWithCount"
}
}
}
}
},
"entryId": "tweet-2087955592526651854",
"sortIndex": "2088015220260732928"
}
],
"type": "TimelineAddEntries"
}
],
"responseObjects": {
"feedbackActions": [
{
"key": "-2134788070",
"value": {
"childKeys": [
"269351462",
"-1399782652"
],
"clientEventInfo": {
"action": "click",
"component": "result",
"element": "feedback_givefeedback"
},
"confirmation": "Thanks for offering your feedback. X is conducting research to improve search. Choose the option that best reflects your opinion.",
"confirmationDisplayType": "Inline",
"feedbackType": "GiveFeedback",
"hasUndoAction": true,
"icon": "Frown",
"prompt": "This post's not helpful"
}
},
{
"key": "269351462",
"value": {
"clientEventInfo": {
"action": "click",
"component": "result",
"element": "feedback_notrelevant"
},
"confirmation": "Thanks for your help.\nThis feedback will be used in research to improve the search function.",
"confirmationDisplayType": "Inline",
"feedbackType": "NotRelevant",
"hasUndoAction": true,
"prompt": "This post isn't relevant"
}
}
]
}
}
}
},
"result_count": 20,
"has_more": true,
"credits_used": 1,
"endpoint": "twitter/search"
}{
"error": "query is required",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Failed to search Twitter",
"endpoint": "search"
}💳 1 credit per request
Authorizations
Query Parameters
The search query text
Example:
"AI"
The type of search results to return. Defaults to Top if not provided.
Available options:
Top, Latest, People, Photos, Media, Lists Example:
"Top"
Pagination cursor from a previous response to get the next page of results
Response
Successful response
Key Response Fields:
Pagination:
has_more:falsewhen this page returned no results — the signal to stop paginating (keep paging whiletrue)result_count: Number of results (tweets or users) on this pagedata.cursor.bottom: Pass ascursorquery param to get the next page of resultsdata.cursor.top: Cursor for the previous/newer page
Search Results (type=Top):
data.result.timeline.instructions[0].entries[]: Array of result entries (typeTimelineAddEntries)
People Carousel (first entry when type=Top):
entries[0].content.items[]: Array of matched user profiles displayed in a carouselentries[0].content.header.text: Will bePeople- Each user at
.item.itemContent.user_results.result:.rest_id: User's numeric ID.is_blue_verified: Blue checkmark status.legacy.name: Display name.legacy.screen_name: Handle (username without @).legacy.description: Bio.legacy.followers_count: Follower count.legacy.friends_count: Following count.legacy.profile_image_url_https: Profile picture URL.legacy.verified_type:Businessfor business accounts
Tweet Results (subsequent entries):
- Each tweet at
entries[].content.itemContent.tweet_results.result:.rest_id: Tweet ID.legacy.full_text: Tweet text.legacy.created_at: Timestamp.views.count: View count (string).legacy.favorite_count: Likes.legacy.retweet_count: Retweets.legacy.reply_count: Replies.legacy.quote_count: Quote tweets.legacy.bookmark_count: Bookmarks
Feedback Actions:
data.result.timeline.responseObjects.feedbackActions[]: Internal feedback metadata (can ignore)