Playground Sign in Start free
Social and video · tiktok.com

How to scrape TikTok

TikTok (tiktok.com) is a social platform. This guide is built from our own checks of its public pages: what the pages contain, whether our requests get through right now, and the request settings that worked.

Ujeebu scrapes any public website. Not listed here? Try any URL in the Playground or ask us about a site.

Working 5 credits a page, about $0.50 per 1,000 on Pro

21 of 21 of our checks passed in the last 7 days (100%).

Last check 2026-11-22 20:02 UTC · last pass 2026-11-22 20:02 UTC · checked with our own requests, never customer data.

Try it in the Playground

Recipe one call

Use the TikTok recipe: send the URL, get JSON

5 credits (JS) a page
curl -G 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: $UJEEBU_API_KEY" \
  --data-urlencode 'url=https://www.tiktok.com/@nba' \
  --data-urlencode 'recipe=tiktok'

The answer is {"result": {...}} with the fields of the recipe. Billed like any /scrape call: successful responses cost credits; blocked, timed-out and failed requests are free.

Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →

Recipe

Call the recipe by name with the recipe parameter: the Scrape API applies its extract rules and the settings that work on TikTok. Each recipe was run on two real TikTok pages and keeps only the fields that came back on both; it is checked again every week, and hidden if it stops working.

Public pages

Validated 2026-11-18

One call: recipe=tiktok 5 credits (JS) a page

curl -G 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: $UJEEBU_API_KEY" \
  --data-urlencode 'url=https://www.tiktok.com/@nba' \
  --data-urlencode 'recipe=tiktok'

The answer is {"result": {...}} with the fields below; the Ujb-Recipe header names the version (for example tiktok/page@v1) and Ujb-Credits the cost.

What this recipe extracts

FieldTypeExample
account_nametextNBA
accounttextnba
followerstext27.4M
followingnumber (as text)268
likestext1.2B
biotextHome of NBA hoops on TikTok 🏀

Examples from www.tiktok.com/@nba on 2026-11-18, shortened.

Sample output (real, trimmed)

{
    "account_name": "NBA",
    "account": "nba",
    "followers": "27.5M",
    "following": "268",
    "likes": "1.2B",
    "bio": "Home of NBA hoops on TikTok 🏀"
}
extract_rules (6 rules): the rules behind the recipe

The API applies these rules and the settings js=true, wait_for=2000 for you when you send recipe=tiktok. To change what comes back, send your own extract_rules (they replace the recipe's) or any setting (yours always win). Sites without a recipe work the same way with extract rules.

{
    "account_name": {
        "selector": "[data-e2e='user-title']",
        "type": "text"
    },
    "account": {
        "selector": "[data-e2e='user-subtitle']",
        "type": "text"
    },
    "followers": {
        "selector": "[data-e2e='followers-count']",
        "type": "text"
    },
    "following": {
        "selector": "[data-e2e='following-count']",
        "type": "text"
    },
    "likes": {
        "selector": "[data-e2e='likes-count']",
        "type": "text"
    },
    "bio": {
        "selector": "[data-e2e='user-bio']",
        "type": "text"
    }
}

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one calls the recipe by name (the Go SDK has no recipe field, so the Go script sends the recipe's rules and settings itself), prints the extracted JSON, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

Public pages

Runs the recipe on the two pages it was validated on, one after the other.

tiktok_page_sdk.py pip install ujeebu-python==0.1.5
# Scrape TikTok public pages with the Ujeebu Scrape API.
# Calls the recipe tiktok: the API applies its extract rules and validated settings (validated 2026-11-18). Send extract_rules or any setting to override them.
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 tiktok_page_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://www.tiktok.com/@nba",
    "https://www.tiktok.com/@natgeo",
]
RECIPE = "tiktok"  # rules and settings come from the recipe; add your own to override them


def scrape(client, url):
    # a GET with recipe=: the API applies the recipe and answers {"result": {...}}
    try:
        response = client.scrape(url, params={"recipe": RECIPE})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}, Ujb-Recipe: {response.headers.get('Ujb-Recipe')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    result = scrape(client, url)
    print(result.get("account_name"), result.get("followers"), result.get("following"), result.get("account"))
    # Example output: NBA 27.5M 268 nba
    # every field: print(json.dumps(result, indent=2, ensure_ascii=False))

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/tiktok.json.

Try it yourself

Run this on TikTok with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card.

URL patterns and pagination

What the URLs look like, read from the pages our checks fetched.

Public pages

Pattern
https://www.tiktok.com/{slug}
Validated on
https://www.tiktok.com/@nbahttps://www.tiktok.com/@natgeo

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Endpoint/scrape
jstrue
wait_for8000
scroll_downtrue
Costup to 5 credits a request
Learnedjs + wait 8000 + scroll (found by our retry layer)

Each public page is one request: change the path in the URL to fetch another one. Our checks pass with JavaScript rendering on (js=true) and a wait of 8 seconds (wait_for=8000) before the snapshot: keep both.

Try it in the Playground

Troubleshooting

The failures our own checks of tiktok.com ran into over the last 7 days, and what got the page in the same check.

What happenedTimesWhat fixed it
A different page than expected 2 A retry with scroll_down=1 got the page (2 of 2).

What people build with TikTok data

  • Market researchFollow public company pages and job postings to see who grows and hires.More on this use case

Limits and etiquette

  • Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
  • Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
  • robots.txt of www.tiktok.com (read 2026-11-17): public pages allowed for generic crawlers; no crawl delay set.
  • Read TikTok's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape TikTok with Ujeebu?

Yes. 21 of 21 checks of public TikTok pages passed in the last 7 days with the settings on this page.

Which settings work for TikTok?

Call /scrape with js=true, wait_for=8000, scroll_down=true. Our retry layer found that this site needs "js + wait 8000 + scroll".

How many credits does a TikTok request cost?

With these settings a request costs up to 5 credits. Only responses with HTTP 200 or 404 are billed: a blocked or timed-out request is free.

Which fields can I extract from TikTok?

With the extraction recipes on this page, validated on real TikTok pages through our API: public pages: account_name, account, followers, following, likes, bio. Pass the recipe as extract_rules in a POST to /scrape and the API returns those fields as JSON.

Is it allowed to scrape TikTok?

Its robots.txt allows generic crawlers on the page types in this guide. Collect public pages only, read TikTok's terms of service, keep your request rate modest and do not collect personal data you have no basis to process. This is not legal advice.

How fresh is this page?

The status and settings come from our own health checks of tiktok.com, which run around the clock. Last check: 2026-11-22 20:02:10 UTC; last pass: 2026-11-22 20:02:10 UTC.