GET/v1/results

Get Results

Retrieve scraped Twitter search results

Retrieve scraped tweets from your Twitter search queries. Each result contains tweet content, engagement metrics, media attachments, and user information.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Core Result Fields

integer

Unique result identifier

Example: 53557759

object

string

Always "result"

Example: result

squid

string

Squid that produced this result

Example: 72d18e4c94534b829877bb7c092b1f80

run

string

Run that produced this result

Example: 3ff48bb8ef19426e87fbb3e102dd4531

Tweet Information

content

string

Full text content of the tweet

Example: This is the tweet text...

name

string

Display name of the tweet author

Example: Elon Musk

username

string

Twitter handle without @

Example: elonmusk

user_id

string

Twitter's internal user ID

Example: 44196397

tweet_url

string

Direct URL to the tweet

Example: https://x.com/elonmusk/status/...

internal_unique_id

string

Twitter's internal tweet ID

Example: 1234567890123456789

published_at

string

Tweet publication timestamp (ISO 8601)

Example: 2025-07-04T04:05:30Z

Engagement Metrics

likes

integer

Number of likes

Example: 15000

retweet_count

integer

Number of retweets

Example: 5000

reply_count

integer

Number of replies

Example: 1000

quote_count

integer

Number of quote tweets

Example: 500

bookmarks_count

integer

Number of bookmarks

Example: 2000

views_count

integer

Number of views

Example: 1000000

Tweet Type Flags

is_retweeted

boolean

Whether this is a retweet

Example: false

is_quoted

boolean

Whether this is a quote tweet

Example: false

original_tweet_id

string

ID of original tweet if retweeted/quoted

Example: 1234567890123456780

original_tweet_url

string

URL of original tweet if retweeted/quoted

Example: https://x.com/user/status/...

Media Attachments

media_N_thumbnail

string

Thumbnail URL for the media item

Example: https://pbs.twimg.com/...

media_N_type

string

Type of media (photo, video, etc.)

Example: photo

media_N_url

string

Direct URL to the media item

Example: https://pbs.twimg.com/...

Twitter Card Fields

binded_media_title

string

Title of the Twitter Card

Example: Article Title

binded_media_description

string

Description of the Twitter Card

Example: Article description...

binded_media_url

string

URL the card links to

Example: https://example.com/article

binded_media_domain

string

Domain of the linked URL

Example: example.com

binded_media_thumbnail_url

string

Thumbnail image of the card

Example: https://example.com/image.jpg

Timestamps

scraping_time

string

When this tweet was scraped (ISO 8601)

Example: 2025-07-04T04:08:09.340Z

Parameters

squidstring

Required

Hash of the squid to get results from

Example: 72d18e4c94534b829877bb7c092b1f80

runstring

Optional

Hash of a specific run (optional)

Example: 3ff48bb8ef19426e87fbb3e102dd4531

pageinteger

Optional

Page number (default: 1)

Example: 1

page_sizeinteger

Optional

Results per page (default: 50, max: 100)

Example: 50

Pro Tip

Use `views_count` to identify viral tweets in your search results.

Pro Tip

Check `is_retweeted` and `is_quoted` to filter out reposts from original content.

Note

Media fields use N as a placeholder for 0-3 (e.g., `media_0_url`, `media_1_url`).