40% off this week — start free, 100MB, no card
TikTok · API

TikTok — Get ad details Scraper API

Resolve a TikTok Creative Center ad URL into ad metadata. Returns structured JSON from a single API call — no proxies, browsers or parsers to maintain.

$0.60per 1,000
$0.0006 per request
JSONresponse
structured & documented
1parameter
1 required
RESTAPI
one endpoint, one key
Quickstart

One request. Structured JSON back.

POST the scraper slug and your parameters to a single endpoint, authorized with your API key. No proxies to rotate, no browser to run — the response is parsed and ready to use.

curl -X POST https://app.serpproxies.com/api/v1/scrape \
  -H "Authorization: Bearer $SERP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"tiktok-ads-details","params":{"url":"https://example.com"}}'
Reference

Request parameters

TikTok — Get ad details accepts 1 parameter. Pass them in the "params" object of your request body.

ParameterTypeRequiredDescription
urltextRequiredURL
API reference

Auth, rate limits and errors.

One key, one endpoint and a predictable response envelope — the same contract applies to every scraper.

Authentication

Send your API key as an "Authorization: Bearer <key>" header, or as "x-api-key: <key>". Create and rotate keys in the dashboard — one key works across all 179 scrapers.

Rate limits

Up to 120 requests per minute per key; exceed it and the API returns 429. For large jobs, reach out and we'll raise your limit. Your balance is drawn only on a successful scrape.

StatusMeaningWhen
200OKsuccess: true, with the parsed result in data.
400Bad requestMissing slug or a required input parameter.
401UnauthorizedMissing or invalid API key.
402Payment requiredInsufficient balance — top up to continue. Not charged.
404Not foundThe slug doesn't match a scraper.
429Too many requestsOver 120 requests/minute for this key.
502 / 503Scrape failed / unavailableUpstream problem — you're not charged.
500Server errorUnexpected error — you're not charged.
Error envelope
{
  "success": false,
  "data": null,
  "error": "Insufficient balance"
}

Every response uses the same shape — success, data and error — so you branch on one field.

Use cases

Where the TikTok scraper fits.

Creator-economy tools, brand-monitoring platforms, agencies and social analytics.

Influencer discovery

Rank creators by real follower counts and engagement, not vanity metrics.

Content analytics

Track views, likes, shares and comments across videos over time.

Trend detection

Surface breakout sounds, hashtags and videos as they take off.

Brand & sentiment monitoring

Watch mentions and comment sentiment on any handle or tag.

Competitive benchmarking

Compare a brand's TikTok footprint against its rivals.

vs the official API

TikTok's official APIs are approval-gated and narrow.

Why teams reach for the TikTok scraper instead of an official API.

The official API

TikTok's Research and Display APIs require an application, are region-restricted, and expose only a slice of public data under strict use terms. Most public profile, video and comment data simply isn't available through them.

SerpProxies
  • Sign up and call it in minutes — no application, partner status or approval.
  • The full public page, parsed into a stable, documented JSON shape.
  • Flat $0.60 per 1,000 requests, pay-as-you-go; failed requests are free.
  • We run the proxies, browsers and anti-bot handling — nothing to maintain.
Pricing

Simple, usage-based pricing.

One flat rate across all 179 scrapers, drawn from your prepaid balance as you go. No tiers to decode, no overage traps — top up and start pulling data.

  • Only successful requests are billed
  • No subscription or seat fees
  • Balance never expires
  • Every scraper, one flat rate
$0.60/ 1,000 requests
That's $0.0006 per successful request.
Why SerpProxies

A data API, not a reseller.

01

We run the network

Every scraper runs on proxies and browsers we own and operate. There's no reseller markup and no separate proxy bill — the request price is the whole price, and it already includes the anti-bot work.

02

Pay per successful request

Flat pricing at $0.60 per 1,000 requests, billed from your balance as you go. Failed requests aren't charged, nothing expires, and there's no monthly minimum or seat licensing to reason about.

03

Structured JSON, not HTML

Each endpoint returns a stable, documented shape — parsed, typed and consistent — so you build against a schema instead of babysitting brittle CSS selectors that break on every redesign.

04

One API, one key

179 scrapers share a single endpoint, a single auth key and a single balance. Learn it once and every source — from Google to TikTok to Booking.com — works the same way.

Related

More scrapers in this category

FAQ

Questions, answered.

Resolve a TikTok Creative Center ad URL into ad metadata. The response is structured JSON with a consistent shape, so you can parse it directly instead of scraping HTML.

Start using the TikTok — Get ad details scraper.

Create an account, grab your API key and send your first request in minutes. Flat pricing, structured JSON, no proxies to run.

  • No credit card required
  • ·Pay per successful request
  • ·179 scrapers, one key