Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "internal_unique_id": "<string>",
  "tweet_url": "<string>",
  "original_tweet_url": "<string>",
  "original_tweet_id": "<string>",
  "name": "<string>",
  "user_id": "<string>",
  "username": "<string>",
  "published_at": {},
  "content": "<string>",
  "views_count": 123,
  "retweet_count": 123,
  "likes": 123,
  "quote_count": 123,
  "reply_count": 123,
  "bookmarks_count": 123,
  "media_0_thumbnail": "<string>",
  "media_0_type": "<string>",
  "media_0_url": "<string>",
  "media_1_thumbnail": "<string>",
  "media_1_type": "<string>",
  "media_1_url": "<string>",
  "media_2_thumbnail": "<string>",
  "media_2_type": "<string>",
  "media_2_url": "<string>",
  "media_3_thumbnail": "<string>",
  "media_3_type": "<string>",
  "media_3_url": "<string>",
  "binded_media_url": "<string>",
  "binded_media_domain": "<string>",
  "binded_media_thumbnail_url": "<string>",
  "binded_media_title": "<string>",
  "binded_media_description": "<string>",
  "is_reply": true,
  "is_retweeted": true,
  "is_quoted": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve scraped data from your Twitter Search Results Scraper runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
squid
string
required
Hash of the squid to get results from
​
run
string
Hash of a specific run (optional)
​
page
integer
Page number (default: 1). Example: 1

​
Result Fields

Each result object contains the following fields:
​
internal_unique_id
string
Unique internal identifier for the tweet. Example: 1886958273636507688
​
tweet_url
string
Direct URL to the tweet on Twitter/X. Example: https://twitter.com/ultrabogotano/status/1886958273636507688
​
original_tweet_url
string
URL of the original tweet (populated if this is a retweet or quote tweet)
​
original_tweet_id
string
Unique identifier of the original tweet (for retweets and quote tweets). Example: 1884600403884380413
​
name
string
Display name of the tweet author. Example: Surfer Calavera
​
user_id
string
Unique internal Twitter/X identifier of the tweet author. Example: 277545465
​
username
string
Twitter/X handle of the author (without the @ symbol). Example: ultrabogotano
​
published_at
datetime
Date and time the tweet was published. Example: 2025-02-05T02:01:25+00:00
​
content
string
Full text content of the tweet. Example: Sigan usando todos los sufijos numéricos que quieran, @Tigo_Colombia. Yo les sigo respondiendo como se merecen ya que no han sido capaces de borrar mi número de su base de datos. @sicsuper https://t.co/qedLjpDMAC
​
views_count
integer
Total number of times the tweet has been viewed. Example: 343
​
retweet_count
integer
Number of times the tweet has been retweeted. Example: 0
​
likes
integer
Number of likes the tweet received. Example: 1
​
quote_count
integer
Number of times the tweet has been quoted. Example: 0
​
reply_count
integer
Number of replies to the tweet. Example: 1
​
bookmarks_count
integer
Number of times the tweet has been bookmarked. Example: 1
​
media_0_thumbnail
string
Thumbnail URL of the 1st media item in the tweet (0-indexed). Example: https://pbs.twimg.com/media/Gi_SiztWMAEoLZd.jpg
​
media_0_type
string
Type of the 1st media item (e.g. photo, video, animated_gif). Example: photo
​
media_0_url
string
URL of the 1st media item in the tweet. Example: https://pbs.twimg.com/media/Gi_SiztWMAEoLZd.jpg
​
media_1_thumbnail
string
Thumbnail URL of the 2nd media item attached to the tweet. Example: https://pbs.twimg.com/media/Gi_SizvXoAAbRzD.jpg
​
media_1_type
string
Type of the 2nd media item (e.g. photo, video). Example: photo
​
media_1_url
string
URL of the 2nd media item attached to the tweet. Example: https://pbs.twimg.com/media/Gi_SizvXoAAbRzD.jpg
​
media_2_thumbnail
string
Thumbnail URL of the 3rd media item attached to the tweet. Example: https://pbs.twimg.com/media/Gi_SizqWUAAerP8.jpg
​
media_2_type
string
Type of the 3rd media item (e.g. photo, video). Example: photo
​
media_2_url
string
URL of the 3rd media item attached to the tweet. Example: https://pbs.twimg.com/media/Gi_SizqWUAAerP8.jpg
​
media_3_thumbnail
string
Thumbnail URL of the 4th media item attached to the tweet
​
media_3_type
string
Type of the 4th media item (e.g. photo, video)
​
media_3_url
string
URL of the 4th media item attached to the tweet
​
binded_media_url
string
URL of a linked media card (e.g. article preview) embedded in the tweet
​
binded_media_domain
string
Domain of the linked media card embedded in the tweet
​
binded_media_thumbnail_url
string
Thumbnail image URL of the linked media card
​
binded_media_title
string
Title of the linked media card embedded in the tweet
​
binded_media_description
string
Description text of the linked media card
​
is_reply
boolean
Whether this tweet is a reply to another tweet. Example: false
​
is_retweeted
boolean
Whether this tweet is a retweet of another tweet. Example: false
​
is_quoted
boolean
Whether this tweet quotes another tweet. Example: true