POST

TikTok Shop Creator API

/v1/run/tiktok_shop.creator

TikTok Shop creator performance by handle: GMV range, promoted product count, brand collaborations, follower age/gender/location demographics, category GMV split, and video versus live engagement.

Category shopRequests / mo -Routing 1 lane · no failover

Get ~100 free requests

Pricing

One price, in dollars

pay per request · no subscription · fallbacks added as the catalog grows

Request

Gateway request

discovered operation

↓

Router

↓

Providers · 1

Octopus- served- uptime- p50---$5.50/1k reqflat

↳ One lane serves this endpoint today, so a failed call has nowhere to fail over to. Failed attempts are never billed. Uptime, latency and traffic are measured through the gateway, last 30 days.

Try it

Make your first request

run it free, no key · same shape for every API

handle*stringTikTok handle of the creator or shop account, without the @ (e.g. golinutrition).regionstringLowercase two-letter country code of the TikTok Shop market (e.g. us).

Open in

Get a free key

Sample response

Free runs return only the first 3 results. Fund a key to get the full response.

{
  "data": {
    "audienceAge": [
      {
        "bucket": "example",
        "sharePct": 12.5
      }
    ],
    "audienceGender": [
      {
        "gender": "example",
        "sharePct": 12.5
      }
    ],
    "audienceLocations": [
      {
        "followers": 12500,
        "state": "CA"
      }
    ],
    "avgCommissionRange": "example",
    "avgLiveLikes": 12500,
    "avgLiveViews": 12500,
    "avgVideoComments": 12500,
    "avgVideoLikes": 12500,
    "avgVideoViews": 12500,
    "bio": "A short example description of this item.",
    "brandCollaborations": 13,
    "categories": [
      {
        "categoryId": "general",
        "name": "Example title"
      }
    ],
    "followers": 12500,
    "gmvRange": "example",
    "gpm": 12.5,
    "handle": "alex_rivera",
    "image": "https://example.com/image.jpg",
    "liveCount": 12500,
    "liveEngagementRate": 12.5,
    "nickname": "Example title",
    "postRate": 12.5,
    "promotedProducts": 42,
    "rating": 4.6,
    "region": "CA",
    "videoCount": 12500,
    "videoEngagementRate": 12.5
  },
  "found": true
}

Response interface

interface TiktokShopCreatorResponse {
  data: {
    audienceAge?: {
      bucket?: string;
      sharePct?: number;
    }[];
    audienceGender?: {
      gender?: string;
      sharePct?: number;
    }[];
    audienceLocations?: {
      followers?: number;
      state?: string;
    }[];
    avgCommissionRange?: string;
    avgLiveLikes?: number;
    avgLiveViews?: number;
    avgVideoComments?: number;
    avgVideoLikes?: number;
    avgVideoViews?: number;
    bio?: string;
    brandCollaborations?: number;
    categories?: {
      categoryId?: string;
      name?: string;
    }[];
    followers?: number;
    gmvRange?: string;
    gpm?: number;
    handle: string;
    image?: string;
    liveCount?: number;
    liveEngagementRate?: number;
    nickname?: string;
    postRate?: number;
    promotedProducts?: number;
    rating?: number;
    region?: string;
    videoCount?: number;
    videoEngagementRate?: number;
  } | null;
  found: boolean;
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

Request, response, and price

Last verified 2026-08-23 · uptime and latency measured over 30d

POST /v1/run/tiktok_shop.creator

curl -X POST https://api.getanyapi.com/v1/run/tiktok_shop.creator \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"golinutrition"}'

Field	Type	Example value
Request body
handle	string	"golinutrition"TikTok handle of the creator or shop account, without the @ (e.g. golinutrition).
region	string	Lowercase two-letter country code of the TikTok Shop market (e.g. us).
Response
data	object
data.audienceAge	object[]	Follower age distribution.
data.audienceAge[].bucket	string	Age bucket, e.g. 25-34.
data.audienceAge[].sharePct	number	Share of followers in this bucket, as a percentage.
data.audienceGender	object[]	Follower gender distribution.
data.audienceGender[].gender	string	Gender label as published upstream.
data.audienceGender[].sharePct	number	Share of followers, as a percentage.
data.audienceLocations	object[]	Top follower locations.
data.audienceLocations[].followers	integer	Followers in this location.
data.audienceLocations[].state	string	State or region name.
data.avgCommissionRange	string	Banded average affiliate commission rate the creator earns. Empty when upstream does not publish it.
data.avgLiveLikes	number	Average likes per live stream.
data.avgLiveViews	number	Average viewers per live stream.
data.avgVideoComments	number	Average comments per video.
data.avgVideoLikes	number	Average likes per video.
data.avgVideoViews	number	Average views per video.
data.bio	string	Creator bio text.
data.brandCollaborations	integer	Number of distinct brands the creator has collaborated with.
data.categories	object[]	TikTok Shop categories the creator sells in.
data.categories[].categoryId	string	TikTok Shop category id.
data.categories[].name	string	Category display name.
data.followers	integer	Follower count.
data.gmvRange	string	Banded gross merchandise value the creator has driven, e.g. "$25K-$60K". Upstream publishes a band rather than an exact figure.
data.gpm	number	Gross merchandise value per thousand views. Zero when upstream does not publish it.
data.handle	string	TikTok handle of the creator, without the @. Populated whenever the provider has data for the entity.
data.image	string	Creator avatar URL.
data.liveCount	integer	Number of live streams in the measured window.
data.liveEngagementRate	number	Engagement rate on live streams, as a percentage.
data.nickname	string	Display name of the creator. Populated whenever the provider has data for the entity.
data.postRate	number	Share of the creator's posts that carry a shop product, as a percentage.
data.promotedProducts	integer	Number of TikTok Shop products the creator has promoted.
data.rating	number	Creator rating. Zero when upstream does not publish it.
data.region	string	Two-letter country code of the creator's TikTok Shop market.
data.videoCount	integer	Number of videos posted in the measured window.
data.videoEngagementRate	number	Engagement rate on videos, as a percentage.
found	boolean
Price
Price per request	USD	$0.0055
Price /1k req	USD	$5.50

FAQ

About the TikTok Shop Creator API

The AnyAPI TikTok Shop Creator API returns TikTok Shop creator data as normalized JSON from one POST call to /v1/run/tiktok_shop.creator. TikTok Shop creator performance by handle: GMV range, promoted product count, brand collaborations, follower age/gender/location demographics, category GMV split, and video versus live engagement. AnyAPI returns one normalized schema whichever source serves it. It costs from $5.50 per 1,000 requests, in US dollars with no subscription and no monthly minimum.

It costs from $5.50 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

TikTok Shop creator performance by handle: GMV range, promoted product count, brand collaborations, follower age/gender/location demographics, category GMV split, and video versus live engagement. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

More to call

Other TikTok Shop endpoints

Categories · from $1.20 /1k req Category products · from $1.20 /1k req Product · from $2.00 /1k req Product full · from $22.00 /1k req Product reviews · from $2.00 /1k req Search · from $1.20 /1k req Search suggestions · from $1.20 /1k req Shop products · from $1.20 /1k req User showcase · from $2.00 /1k req

Get started

Two ways to start on AnyAPI

Humans fund a USD wallet and pay per request. Agents point a coding agent at one URL and onboard themselves.