jsonscraper

TikTok Engineering Guide

How to scrape TikTok public data with jsonscraper API

Updated March 5, 2026 2 min read

This guide is built strictly from the TikTok Scraper API Postman collection and focuses on operational usage: endpoint classes, request templates, pagination, and stable execution flow.

Instead of abstract examples, this article maps real route groups to real implementation stages: quick validation, class-by-class expansion, and repeatable production requests with controlled cache behavior.

1. Endpoint groups that matter in production

TikTok collection usage is most effective when deployed in phases: start from video/user basics, then add search and feed classes, then expand to trending/effects when your core pipeline is stable.

This rollout model keeps error handling predictable and helps your team separate lookup endpoints from high-volume feed endpoints with different pagination and cache behavior.

The official collection is organized into these classes:

  • Video: info by ID/URL, comments by ID/URL, no-watermark URL, URL unshortening
  • User: profile info, feed, followers/following, social links (Twitter/IG/YouTube), username/ID conversions
  • Search: user/video/music/live/hashtag/location keyword search
  • Hashtag, Location, Music: info + feed endpoints
  • Trending & Effects: categories/feed + stickers/effects endpoints

Popular API requests

Complete endpoint map from the documentation. Expand each class and click any endpoint for params + response details.

Video Search User Hashtag Location Music Trending Effects
Video (7 endpoints)
Search (6 endpoints)
User (14 endpoints)
Hashtag (3 endpoints)
Location (2 endpoints)
Music (2 endpoints)
Trending (2 endpoints)
Effects (3 endpoints)
View full endpoint list in Postman

Request parameters

Most integration quality issues come from inconsistent handling of cursors, region, and cache windows. Normalize these parameters in shared templates before scaling request volume.

Treat these fields as operational controls, not optional metadata: they define response shape, page continuity, and repeated-request cost.

Parameter Used in Purpose
cache_timeoutMost endpointsSets cache lifetime in seconds.
cursor / max_cursor / offsetSearch/feed/followersPagination offsets/cursors.
countSearch/feed/list endpointsLimits number of returned entries.
regionSeveral video/search/feed endpointsRegion-specific data selection where supported.

API documentation in Postman

Fork collection, set your key once, and test every endpoint in a few clicks. Generate code snippets and run automation with AI agents.

Step 1

Fork collection

Copy docs to your workspace and keep your own endpoint setup.

Step 2

Set license key

Configure license_key once and run endpoints instantly.

Step 3

Automate with AI

Build extraction pipelines and reporting workflows on autopilot.

Production checklist

  • Confirm license_key is injected into the final URL for every request.
  • Check at least one endpoint in each class you plan to run in production.
  • Store pagination tokens (cursor, max_cursor, offset) with query context.
  • Set explicit cache_timeout policy by workflow type.
  • Share one approved Postman environment across the whole team.

Quick comparison

Treat pagination state as a first-class part of your data model. Cursor values should always be stored with the exact query context that generated them, including keyword, account, and region attributes.

For cache policy, define separate freshness tiers by business objective: near real-time monitoring can run shorter windows, while reporting and historical enrichment can use longer windows to reduce request pressure and cost.

Operationally, keep request templates immutable, rotate through deterministic polling cycles, and track pagination checkpoints so recovery after transient errors is predictable and does not duplicate work.

Recommended baseline

  • Persist checkpoint tokens after every successful page fetch.
  • Use stable retry logic with bounded attempts and clear fallback path.
  • Separate ingestion, normalization, and delivery stages for easier scaling.

Use cases

The fastest path to value is a focused schema: video-level metrics, creator identity, and search/feed trend windows. Teams usually expand to additional classes only after this baseline is used in reports.

Data slice Primary question it answers Where it is used
Video performance + media metadataWhich content formats are accelerating now?Editorial and paid planning
User and feed snapshotsHow fast are creators/accounts shifting?Creator scoring systems
Search/trending pagesWhich topics are gaining momentum by region?Trend intelligence dashboards
No-watermark utility routesCan media assets be routed into QA/workflow tools?Content operations and archives

Built for teams in

Trend radar for marketing teams

Search and trending endpoints feed hourly topic monitors that highlight new themes before they saturate.

Creator scouting and qualification

User/video routes are combined into scoring rules for shortlisting creators by velocity, consistency, and content profile fit.

UGC moderation intake

Video metadata and utility endpoints route candidate assets into review queues for legal and brand checks before publication.

Automation stacks with low ops overhead

Teams orchestrate pulls in n8n, Make, or Zapier, push normalized rows to warehouse tables, and distribute dashboards to product and growth stakeholders.

Ready to launch your API workflow?

Start with one high-signal route class, map outputs into your destination table, then expand coverage once consumers actively use the first dashboard or automation flow.