Collector

TikTok Videos scraper

Everything TikTok publishes about a video you have the address of — plays, likes, comments, shares, saves and reposts, the caption and its hashtags, the sound, the author and their counts, one row per video.

On this page

What it collects

socialProxy advised

Everything TikTok publishes about a video you have the address of — plays, likes, comments, shares, saves and reposts, the caption and its hashtags, the sound, the author and their counts, one row per video. It is a scraper, which means the whole contract is: fill in the form, and one table comes back. No browser window opens, it costs none of your plan's automation slots, and the requests go out over plain HTTP carrying a real browser's TLS fingerprint.

At volume this target is sensitive to where the request leaves from, so pick a proxy on the run — it is advice at the form rather than a gate, and a run without one still starts. Whichever way it went, every row records it — see the provenance columns below.

What you give it — 6

The form the app draws, read out of the card itself. Each hint below is the one shown beside that field in the run dialog, so nothing here is a description of the product written separately from it.

The one answer it needs

videos
Video URLs · list · required

One video URL per line. The address needs the @handle as well as the id, so a bare video id is skipped — TikTok answers /video/<id> on its own with a redirect and no data. Run TikTok Profile Videos first if you have accounts rather than addresses; its Video column is what this box takes.

Everything else is optional

minPlays
Minimum plays · number
minLikes
Minimum likes · number
keywords
Caption contains · list

Matches the caption text, which is where the hashtags are written too.

postedWithinDays
Posted in the last (days) · number

Counted from the moment the run starts, so a schedule keeps meaning the same window.

excludeAds
Skip sponsored videos · boolean

What comes back — 39 columns

One dataset per run — a typed table your workspace owns, which you can then sort, filter, edit in the grid, export whole, or read back over the local API. These are the columns it is created with.

5 columns are marked may be empty. That is a fact about the record rather than about the collector — a post with nowhere tagged, an account with no business category — and it is said out loud so a blank cell does not read as a broken scraper. A column the reply never carries at all is deleted upstream rather than shipped empty, so nothing here is decoration.

35 from TikTok Videos

KeyColumnType
webVideoUrlVideourl
textCaptionmay be emptylongText
postedAtPosteddatetime
playsCountPlaysnumber
likesCountLikesnumber
commentsCountCommentsnumber
sharesCountSharesnumber
savesCountSavesnumber
repostsCountRepostsnumber
hashtagsHashtagsmay be emptytext
hashtagCountTagsnumber
authorHandleAuthortext
authorNameAuthor nametext
authorProfileUrlAuthor profileurl
authorFollowersAuthor followersnumber
authorLikesAuthor likesnumber
authorVideosAuthor videosnumber
authorIdAuthor idtext
musicNameSoundtext
musicAuthorSound bymay be emptytext
musicOriginalOriginal soundtext
musicDurationSound lengthnumber
musicIdSound idtext
durationLengthnumber
widthWidthnumber
heightHeightnumber
definitionQualitytext
formatFormattext
coverUrlCoverurl
textLanguageLanguagemay be emptytext
locationCreatedPosted frommay be emptytext
isAdAdtext
aiGeneratedAI generatedtext
videoIdVideo idtext
searchTermFound viatext

4 that every scraper writes

The same four on every card, so a table can still answer months later how its rows got there: which service they came from, when, which profile's identity the requests carried, and whether that identity was signed in.

KeyColumnType
platformPlatformtext
collected_atCollected atdatetime
profileCollected byprofile
logged_inSigned inselect

Four ways to run it

The Scrapers tab. Pick the card, fill in the form, press Start. Every run started here makes a new table, named after what you searched for and when. Check first if you like — it collects one page, writes nothing, and reports which columns came back filled.

Ask the assistant. It has the whole catalogue, so this card is a sentence rather than a form. It fills in the parameters above from what you said and shows you them before it starts.

Over MCP or the local API. The same card, from a coding agent — argus_run_scraper over the MCP server, or POST http://127.0.0.1:39219/v1/scrapers/run on the local API. There is a sample call beside it that writes nothing.

argus_run_scraper — TikTok Videos
{
  "kind": "tiktok_videos",
  "inputs": {
    "videos": [
      "…"
    ]
  }
}

As a step inside a workflow. The Run scraper step puts this collector in the middle of an automation — collect, then filter, then mail — and the tree still opens no window doing it. It is also the one caller that can overrule the table-per-run rule: pointed at a table you name, it creates that table with the columns above if it is missing and files every run into it after, appending or updating the row in place on a column you match on. The step hands the next one the table's name, its id and the row count.

Where it stops

It will not drive a page. Anything that needs a real browser — a site with no list endpoint behind it, or anything operating an account of your own — is an automation instead, and that is a different tool rather than a worse version of this one.

It signs in to nothing. Reading a public page signed out is the settled position — Bright Data scraped Meta signed out and won; hiQ scraped LinkedIn signed in and lost — so this card asks for no account and holds none.

The rest of the TikTok cards

One card per job rather than per service — profiles, posts and the people around them are three collections with three schemas.