TikTok Scraper introduction
The Scrapeless TikTok Scraper provides separate actors for account profiles, an account’s posts, and TikTok Shop product details. All three use the shared Scraping API request endpoint and return JSON.
Choose an actor
| Operation | Actor | Required input | Documented result |
|---|---|---|---|
| User Detail | scraper.tiktok.user.detail | unique_id | Account profile and statistics |
| User Work | scraper.tiktok.user.work | sec_uid | An items array containing the account’s posts |
| Shop Page | scraper.tiktok.shop.page | product_id, region | TikTok Shop product details |
What you can retrieve
Account profiles. User Detail’s published example includes account identifiers, nickname, profile URL, avatar URLs, statistics, and verification flags.
Account posts. User Work’s example includes post URLs, descriptions, engagement counts, video details, and author information. It takes the account’s sec_uid, which is available in the User Detail response.
Shop products. Shop Page’s example includes product and seller identifiers, pricing, stock, rating, images, options, and SKUs. Supply a product ID and a region code for this operation.
How requests work
Send a JSON body to POST https://api.scrapeless.com/api/v1/scraper/request with the chosen actor and its input. Authenticate with the x-api-token header.
HTTP 200 returns the completed result. HTTP 201 returns a taskId for a task that is still processing. Use Results and Polling to retrieve that task.
A profile-to-posts workflow
- Call User Detail with a username in
unique_id. - Read
sec_uidfrom the completed profile response. - Pass that value to User Work to request the account’s posts.
Shop Page is a separate workflow using product_id and region.
Next steps
Start with Quickstart for one profile request. Continue to Endpoints for all three actors, their input requirements, and response examples.