Skip to content
Examples

Get Results

Retrieve scraped data from Threads 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 Threads Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

pageintegerquery

Page number (default: 1)

Result Fields

post_urlstring

Direct URL of the post. Example: https://www.threads.net/@zuck/post/Cabcde12345

post_idstring

Numeric identifier of the post. Example: 3456789012345

post_codestring

Short code of the post used in its URL. Example: Cabcde12345

record_typestring

Row type: post or reply. Example: post

source_tabstring

Where the row came from: posts, search, or permalink. Example: posts

search_keywordstring

Keyword or tag searched for (search rows only). Example: AI

scraped_atdatetime

UTC timestamp at which the row was collected. Example: 2026-09-15T10:00:00Z

text_contentstring

Full text of the post. Example: Just launched something new!

published_atdatetime

Publication date of the post in UTC. Example: 2026-09-14T20:00:00Z

languagestring

Language detected by Threads for the post. Example: en

topic_tagstring

Topic/community tag attached to the post. Example: Technology

hashtagsjson

Hashtags found in the post text.

mentionsjson

Handles mentioned in the post text.

mentioned_usersjson

Handles that Threads itself resolved as mentions.

mentioned_accountsjson

Accounts Threads resolved as mentions, with user ids.

like_countbigint

Number of likes. Example: 45231

reply_countbigint

Number of direct replies. Example: 1847

repost_countbigint

Number of reposts. Example: 3210

quote_countbigint

Number of quote posts. Example: 892

share_countbigint

Number of shares. Example: 5612

view_countbigint

Number of views (only on single-post crawls). Example: 1200000

has_mediaboolean

True when the post carries at least one image, video, or carousel. Example: false

media_typestring

Kind of media: text, image, video, carousel, or audio. Example: text

media_urlsjson

URLs of the post media.

media_widthinteger

Width in pixels of the post media. Example: 1080

media_heightinteger

Height in pixels of the post media. Example: 1080

has_audioboolean

True when the attached video carries audio. Example: false

accessibility_captionstring

Alt text of the media.

is_gifboolean

True when the post attaches a GIF. Example: false

music_titlestring

Title of the music track attached to the post.

music_artiststring

Artist of the music track.

urlsjson

External links in the post.

link_titlestring

Title of the link preview attached to the post.

is_paid_partnershipboolean

True when the post is flagged as a paid partnership. Example: false

is_pinnedboolean

True when the post is pinned. Example: false

is_editedboolean

True when the post text was edited. Example: false

is_spoilerboolean

True when the media is marked as a spoiler. Example: false

is_ai_generatedboolean

True when Threads flags the post as AI-generated. Example: false

reply_controlstring

Who is allowed to reply to the post. Example: everyone

is_replyboolean

True when the post is a reply to another post. Example: false

reply_to_usernamestring

Handle of the account this post replies to.

is_quote_postboolean

True when the post quotes another post. Example: false

quoted_post_urlstring

URL of the quoted post.

is_repostboolean

True when the post is a repost. Example: false

reposted_post_urlstring

URL of the reposted post.

usernamestring

Handle of the post author. Example: zuck

user_idstring

Numeric identifier of the post author. Example: 314216

display_namestring

Display name of the post author. Example: Mark Zuckerberg

profile_urlstring

URL of the post author profile. Example: https://www.threads.net/@zuck

profile_pic_urlstring

Profile picture of the post author. Example: https://scontent.example.com/v/t51.2885-19/zuck_profile.jpg

is_verifiedboolean

True when the post author is verified. Example: true

is_privateboolean

True when the post author account is private. Example: false

followers_countbigint

Number of followers (profile crawls only). Example: 12500000

biostring

Biography of the crawled profile (profile crawls only).

bio_linksjson

Links listed in the profile biography.

profile_tagsjson

Topic tags displayed on the profile.

profile_pic_hd_urlstring

Highest resolution profile picture (profile crawls only).

fediverse_enabledboolean

True when the profile is reachable on the fediverse. Example: true

Code Examples

curl -G https://api.lobstr.io/v1/results \
  -H "Authorization: Token YOUR_API_KEY" \
  -d "squid=7308ae543e6abc70438d6b968d3a1b38" \
  -d "page=1"

Response

200
{"total_results": 1, "data": [{"post_id": "3456789012345", "text_content": "Just launched something new!", "username": "zuck", "like_count": 45231, "reply_count": 1847, "published_at": "2026-09-14T20:00:00Z", "is_verified": true}]}