One term to fan out across every term-driven source at once: it is used as the account handle, the search keyword, the advertiser name, the shop keyword and the hashtag. Leave empty to use the per-source fields below (flexible mode). Any per-source field you also fill overrides the query for that source.

Type:string

Example:

nike

Accounts

profiles

Optional

TikTok handles or profile links. Returns the account plus its recent videos.

Type:array

Example:

[
  "@nasa"
]

Search keywords

keywords

Optional

Keywords to search. Returns matching videos per keyword.

Type:array

Example:

[
  "space launch"
]

Videos to read comments from

comment_videos

Optional

Video links or ids. Returns one row per comment (and reply, if enabled).

Type:array

Videos to download

download_videos

Optional

Video links or ids. Returns the media file/URL and quality ladder per video.

Type:array

Ad-library advertisers

advertisers

Optional

Advertiser names to look up in the TikTok Ad Library. One row per ad.

Type:array

Shop keywords

shop_keywords

Optional

Keywords to search TikTok Shop. One row per product.

Type:array

Hashtags

hashtags

Optional

Hashtags to look up. Returns reach figures (TikTok does not serve the tag's video list).

Type:array

Related to videos

related_to

Optional

Seed video links or ids. Returns the videos TikTok lists as related to each, ~16 per seed.

Type:array

Explore feed videos

explore

Optional

How many videos to pull from TikTok's public Explore feed. 0 disables it. May require the signed path; the run reports the reason if it refuses.

Type:integer

Minimum:0

Maximum:30

Default:0

Explore category

explore_category

Optional

Optional Explore category id. Leave as 0 for the default mixed feed.

Type:string

Default:0

Sources to run

sources

Optional

Limit the run to these sources: profile, search, comments, downloads, ads, shop. Leave empty to run every source that has input.

Type:array

Region / country

region

Optional

Two-letter country code for the proxy exit and market (e.g. US, NL). Applied to every source that supports it.

Type:string

Default:US

Maximum results per source call

max_per_source

Optional

Cap on rows fetched per sub-actor call (videos per account, comments per video, products per keyword, etc.).

Type:integer

Minimum:1

Maximum:500

Default:50

Include comment replies

include_replies

Optional

When reading comments, also fetch replies.

Type:boolean

Default:false

Download quality

quality

Optional

Preferred quality for video downloads (passed to the downloader). Leave empty for its default.

Type:string

Concurrent sub-actor calls

concurrency

Optional

How many sub-actor calls to run at once.

Type:integer

Minimum:1

Maximum:6

Default:3

Sub-actor id overrides (advanced)

actor_ids

Optional

Override the sub-actor called per source, e.g. {"profile": "me/my-fork"}. For forks and testing.

Type:object

X Twitter Scraper - Profiles, Posts, Engagement

s-r/x-twitter-scraper

Scrape X (Twitter) by handle, post ID, or search term with X's own advanced-search operators. Returns profiles with follower counts and posts with likes, reposts, replies, quotes, bookmarks and view counts, plus filters for language, date, engagement and media.

Facebook Page Posts Scraper

s-r/facebook-pages

Read the posts on any public Facebook page: text, posting date, exact and displayed reaction and share counts, attachment type and whether the post is sponsored. Paste page handles or links. No login.

Snapchat Ads Library

s-r/snapchat-ads-library

Search Snapchat's political ad library and get rows with exact spend, impressions and a computed CPM, the paying advertiser and the organisation, start and end dates, the creative URL, and the full targeting spec down to electoral districts. Any year from 2019.

Amazon Seller Emails

s-r/amazon-seller-emails

TikTok Comment Scraper - Comments & Replies

s-r/tiktok-comment-scraper

Read the comments on any TikTok video. Text, author, likes, reply counts and timestamps, with full reply threads on request.

Google Play Store Scraper - Apps & Ratings

s-r/google-play

Read Google Play apps by package name or search: title, developer, category, rating, install band, description and icon. Returns all three of Play's differing review counts under names that say what they are.

Xiaohongshu Scraper

s-r/xiaohongshu-scraper

Paste Xiaohongshu note links, or leave them empty to read the public feed, and get rows with title, body text, author, publish date, hashtags, image count and all four engagement counters: likes, comments, collects and shares. No account, no keyword search.

Newegg Scraper

s-r/newegg-scraper

Search Newegg and get product rows: current price, previous price, the saving in dollars and percent, rating, review count, shipping and free-shipping flag, brand, model and Newegg's item number, plus the spec line parsed into fields. Deals-only mode included.

StepStone Jobs Scraper

s-r/stepstone-scraper

A StepStone scraper that returns job postings from Germany, Austria and Belgium with the job link resolved correctly, the employer profile, the location, the posting age and whether StepStone holds a salary estimate for the role.

TikTok Video Downloader - MP4, All Qualities

s-r/tiktok-video-downloader

Download TikTok videos from a link. Returns a hosted MP4 link that works anywhere, the full quality ladder, and the post's caption, author, sound, hashtags and counters.