Skip to content
Examples

Get Results

Retrieve scraped data from Twitter Search Results Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Twitter Search Results Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

internal_unique_idstring

Unique internal identifier for the tweet. Example: 1886958273636507688

tweet_urlstring

Direct URL to the tweet on Twitter/X. Example: https://twitter.com/ultrabogotano/status/1886958273636507688

original_tweet_urlstring

URL of the original tweet (populated if this is a retweet or quote tweet)

original_tweet_idstring

Unique identifier of the original tweet (for retweets and quote tweets). Example: 1884600403884380413

namestring

Display name of the tweet author. Example: Surfer Calavera

user_idstring

Unique internal Twitter/X identifier of the tweet author. Example: 277545465

usernamestring

Twitter/X handle of the author (without the @ symbol). Example: ultrabogotano

published_atdatetime

Date and time the tweet was published. Example: 2025-02-05T02:01:25+00:00

contentstring

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_countinteger

Total number of times the tweet has been viewed. Example: 343

retweet_countinteger

Number of times the tweet has been retweeted. Example: 0

likesinteger

Number of likes the tweet received. Example: 1

quote_countinteger

Number of times the tweet has been quoted. Example: 0

reply_countinteger

Number of replies to the tweet. Example: 1

bookmarks_countinteger

Number of times the tweet has been bookmarked. Example: 1

media_0_thumbnailstring

Thumbnail URL of the 1st media item in the tweet (0-indexed). Example: https://pbs.twimg.com/media/Gi_SiztWMAEoLZd.jpg

media_0_typestring

Type of the 1st media item (e.g. photo, video, animated_gif). Example: photo

media_0_urlstring

URL of the 1st media item in the tweet. Example: https://pbs.twimg.com/media/Gi_SiztWMAEoLZd.jpg

media_1_thumbnailstring

Thumbnail URL of the 2nd media item attached to the tweet. Example: https://pbs.twimg.com/media/Gi_SizvXoAAbRzD.jpg

media_1_typestring

Type of the 2nd media item (e.g. photo, video). Example: photo

media_1_urlstring

URL of the 2nd media item attached to the tweet. Example: https://pbs.twimg.com/media/Gi_SizvXoAAbRzD.jpg

media_2_thumbnailstring

Thumbnail URL of the 3rd media item attached to the tweet. Example: https://pbs.twimg.com/media/Gi_SizqWUAAerP8.jpg

media_2_typestring

Type of the 3rd media item (e.g. photo, video). Example: photo

media_2_urlstring

URL of the 3rd media item attached to the tweet. Example: https://pbs.twimg.com/media/Gi_SizqWUAAerP8.jpg

media_3_thumbnailstring

Thumbnail URL of the 4th media item attached to the tweet

media_3_typestring

Type of the 4th media item (e.g. photo, video)

media_3_urlstring

URL of the 4th media item attached to the tweet

binded_media_urlstring

URL of a linked media card (e.g. article preview) embedded in the tweet

binded_media_domainstring

Domain of the linked media card embedded in the tweet

binded_media_thumbnail_urlstring

Thumbnail image URL of the linked media card

binded_media_titlestring

Title of the linked media card embedded in the tweet

binded_media_descriptionstring

Description text of the linked media card

is_replyboolean

Whether this tweet is a reply to another tweet. Example: false

is_retweetedboolean

Whether this tweet is a retweet of another tweet. Example: false

is_quotedboolean

Whether this tweet quotes another tweet. Example: true

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 35408,
      "object": "result",
      "squid": "ba8cbb253043c4013bdf3110f36fa5ed",
      "run": "f86fef1dc7b51f51dd8d7844eb707927",
      "internal_unique_id": "1886958273636507688",
      "tweet_url": "https://twitter.com/ultrabogotano/status/1886958273636507688",
      "original_tweet_url": null,
      "original_tweet_id": "1884600403884380413",
      "name": "Surfer Calavera",
      "user_id": "277545465",
      "username": "ultrabogotano",
      "published_at": "2025-02-05T02:01:25+00:00",
      "content": "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.\n@sicsuper https://t.co/qedLjpDMAC",
      "views_count": 343,
      "retweet_count": 0,
      "likes": 1,
      "quote_count": 0,
      "reply_count": 1,
      "bookmarks_count": 1,
      "media_0_thumbnail": "https://pbs.twimg.com/media/Gi_SiztWMAEoLZd.jpg",
      "media_0_type": "photo",
      "media_0_url": "https://pbs.twimg.com/media/Gi_SiztWMAEoLZd.jpg",
      "media_1_thumbnail": "https://pbs.twimg.com/media/Gi_SizvXoAAbRzD.jpg",
      "media_1_type": "photo",
      "media_1_url": "https://pbs.twimg.com/media/Gi_SizvXoAAbRzD.jpg",
      "media_2_thumbnail": "https://pbs.twimg.com/media/Gi_SizqWUAAerP8.jpg",
      "media_2_type": "photo",
      "media_2_url": "https://pbs.twimg.com/media/Gi_SizqWUAAerP8.jpg",
      "media_3_thumbnail": "",
      "media_3_type": "",
      "media_3_url": "",
      "binded_media_url": "",
      "binded_media_domain": "",
      "binded_media_thumbnail_url": "",
      "binded_media_title": "",
      "binded_media_description": "",
      "is_reply": false,
      "is_retweeted": false,
      "is_quoted": true,
      "functions": null,
      "native_id": 35408
    }
  ],
  "next": null,
  "previous": null
}