Data APIs / TikTok

TikTok Scraper API

Profiles with follower, like, and video counts, plus the whole TikTok Shop catalogue: products with exact units sold and per-SKU stock, sellers, store listings, category feeds, and the videos promoting a product.

From 1 credit per call · cache hits free · failed calls refunded · no card for the free tier

One request, structured data and markdown

Every endpoint accepts format=json, markdown, or both. Use the JSON to filter and store; drop the markdown straight into a prompt.

  • Profile: followers, following, likes, video count, bio, verification, bio link
  • Shop product: sold count, per-SKU stock and price, rating histogram, images, review sample
  • Seller profile and full store listings (paginated)
  • Category feeds for spotting what sells
  • The creator videos attached to a product
request
curl 'https://scrapewhale.dev/api/v1/social/tiktok/profile?username=gymshark&format=json' \
  -H 'Authorization: Bearer <api-key>'
response · json
{
  "extractor": "tiktok-profile",
  "creditsCharged": 1,
  "data": {
    "is_available": true,
    "userInfo": {
      "user": { "uniqueId": "gymshark", "nickname": "Gymshark", "verified": true },
      "stats": { "followerCount": 5900000, "heartCount": 128000000, "videoCount": 2400 }
    }
  }
}

Abridged.

Endpoints

6 endpoints in this family. Full parameter reference and a try-it console are in the API docs.

get/api/v1/social/tiktok/profile1 credit

TikTok profile

Profile display name, bio, verification, follower/following/like/video counts, and bio link.

username *
TikTok handle, with or without the leading @.
get/api/v1/tiktok/shop/product1 credit

TikTok Shop product detail

Product detail with exact figures: units sold, per-SKU stock and pricing, rating with the full 1–5 star histogram, categories, images, and a small review sample. Snapshot stock over time and diff it to estimate sales velocity. Region (prices/currency) follows the scraper exit IP.

product_id *
Numeric product id (~19 digits), from a /view/product/<id> or /shop/pdp/<slug>/<id> URL, or from the store/category endpoints.
get/api/v1/tiktok/shop/product/videos1 credit

Videos promoting a TikTok Shop product

TikTok videos promoting a product (up to ~10 — TikTok caps this feed): creator, play and like counts, upload date, and video links. Pair with the product endpoint (units sold) to attribute a product’s sales to the creators and videos driving them.

product_id *
Numeric product id (~19 digits).
get/api/v1/tiktok/shop/seller1 credit

TikTok Shop seller summary

Shop summary by seller id: name, region, rating, items sold, followers, product and review counts. A lightweight lookup — use /api/v1/tiktok/shop/store when you also want the product catalog. Get the seller_id from a product’s detail response.

seller_id *
Numeric seller/store id (~19 digits).
get/api/v1/tiktok/shop/store2 credits

TikTok Shop store catalog

Store info plus the product catalog (~30 products per page, with sold counts, ratings, and prices). The bulk-discovery path: walk a seller’s full catalog here, then feed product_ids into /api/v1/tiktok/shop/product for per-product detail. has_more: true means more pages exist than max_pages fetched.

seller_id *
Numeric seller/store id (~19 digits).
max_pages
Catalog pages of ~30 products to fetch (1–10, default 1).
get/api/v1/tiktok/shop/category1 credit

TikTok Shop category listing

Category info, child categories (walk children[] recursively to enumerate the tree), and the top ~15 products. Deeper category pagination is not exposed upstream — use the store endpoint for exhaustive per-seller catalogs; use categories for top-of-category sampling and tree discovery.

category_id *
Numeric category id, e.g. 700645 (Health). Get child ids from this endpoint’s children[] or a product’s categories[].

What teams use it for

Sales velocity tracking

Snapshot a product's stock and sold count daily and diff it to estimate units per day.

Winning-product research

Scan a category feed for products with rising sold counts.

Creator discovery

Find which creators are promoting a product and how their profiles perform.

Frequently asked questions