API para TikTok Shop

API para TikTok Shop: Criador

Desempenho de um criador do TikTok Shop pelo nome de usuário: faixa de GMV, número de produtos promovidos, parcerias com marcas, perfil demográfico dos seguidores por idade/gênero/localização, divisão do GMV por categoria e engajamento em vídeo versus live.

POST/v1/run/tiktok_shop.creator
Disponibilidade
35,29%
30d · 17 chamadas
Requisições
17
30d
Resposta
6,6s
mediana · 30d

Preços

Um preço, em dólares

Teste

Faça sua primeira requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "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,
  "reason": "not_found"
}
Interface da resposta
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 | null;
    handle: string;
    image?: string;
    liveCount?: number;
    liveEngagementRate?: number;
    nickname?: string;
    postRate?: number;
    promotedProducts?: number;
    rating?: number | null;
    region?: string;
    videoCount?: number;
    videoEngagementRate?: number;
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 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"}'
CampoTipoValor de exemplo
Corpo da requisição
handlestring"golinutrition"Nome de usuário no TikTok do criador ou da conta da loja, sem o @ (ex.: golinutrition).
regionstringCódigo de país de duas letras minúsculas do mercado do TikTok Shop (ex.: us).
Resposta
dataobject
data.audienceAgeobject[]Follower age distribution.
data.audienceAge[].bucketstringAge bucket, e.g. 25-34.
data.audienceAge[].sharePctnumberShare of followers in this bucket, as a percentage.
data.audienceGenderobject[]Follower gender distribution.
data.audienceGender[].genderstringGender label as published upstream.
data.audienceGender[].sharePctnumberShare of followers, as a percentage.
data.audienceLocationsobject[]Top follower locations.
data.audienceLocations[].followersintegerFollowers in this location.
data.audienceLocations[].statestringState or region name.
data.avgCommissionRangestringBanded average affiliate commission rate the creator earns. Empty when upstream does not publish it.
data.avgLiveLikesnumberAverage likes per live stream.
data.avgLiveViewsnumberAverage viewers per live stream.
data.avgVideoCommentsnumberAverage comments per video.
data.avgVideoLikesnumberAverage likes per video.
data.avgVideoViewsnumberAverage views per video.
data.biostringCreator bio text.
data.brandCollaborationsintegerNumber of distinct brands the creator has collaborated with.
data.categoriesobject[]TikTok Shop categories the creator sells in.
data.categories[].categoryIdstringTikTok Shop category id.
data.categories[].namestringCategory display name.
data.followersintegerFollower count.
data.gmvRangestringBanded gross merchandise value the creator has driven, e.g. "$25K-$60K". Upstream publishes a band rather than an exact figure.
data.gpmnumberGross merchandise value per thousand views. Null when upstream does not publish it.
data.handlestringTikTok handle of the creator, without the @. Populated whenever the provider has data for the entity.
data.imagestringCreator avatar URL.
data.liveCountintegerNumber of live streams in the measured window.
data.liveEngagementRatenumberEngagement rate on live streams, as a percentage.
data.nicknamestringDisplay name of the creator. Populated whenever the provider has data for the entity.
data.postRatenumberShare of the creator's posts that carry a shop product, as a percentage.
data.promotedProductsintegerNumber of TikTok Shop products the creator has promoted.
data.ratingnumberCreator rating. Null when upstream does not publish it.
data.regionstringTwo-letter country code of the creator's TikTok Shop market.
data.videoCountintegerNumber of videos posted in the measured window.
data.videoEngagementRatenumberEngagement rate on videos, as a percentage.
foundboolean
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,0055
Preço /mil req.USDUS$ 5,50

Dúvidas frequentes

Sobre o endpoint Criador da API para TikTok Shop

O endpoint Criador da AnyAPI para TikTok Shop retorna dados de TikTok Shop em JSON normalizado com uma chamada POST para /v1/run/tiktok_shop.creator. Desempenho de um criador do TikTok Shop pelo nome de usuário: faixa de GMV, número de produtos promovidos, parcerias com marcas, perfil demográfico dos seguidores por idade/gênero/localização, divisão do GMV por categoria e engajamento em vídeo versus live. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 5,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 35,3% das chamadas ao endpoint Criador da API para TikTok Shop feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 6,6 segundos, em 17 chamadas medidas.

Custa a partir de US$ 5,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Desempenho de um criador do TikTok Shop pelo nome de usuário: faixa de GMV, número de produtos promovidos, parcerias com marcas, perfil demográfico dos seguidores por idade/gênero/localização, divisão do GMV por categoria e engajamento em vídeo versus live. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 35,3% das chamadas ao endpoint Criador da API para TikTok Shop feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 6,6 segundos, em 17 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.