API para TikTok Shop

API para TikTok Shop: Buscar

Busque produtos do TikTok Shop por palavra-chave em 15 países: preço, vendas, avaliação e dados do vendedor de cada produto, em uma única resposta normalizada.

POST/v1/run/tiktok_shop.search
Disponibilidade
100,00%
30d · 15.904 chamadas
Requisições
15.904
30d · semanal, últimas 12 sem.
Resposta
3,0s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `currency`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um produto que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
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": {
    "items": [
      {
        "currency": "USD",
        "discountPct": 12500,
        "image": "https://example.com/image.jpg",
        "originalPrice": 19.99,
        "price": 19.99,
        "productId": "a1b2c3d4",
        "rating": 4.6,
        "reviewCount": 12500,
        "sellerId": "a1b2c3d4",
        "shopName": "Example title",
        "soldCount": 12500,
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TiktokShopSearchResponse {
  data: {
    items: {
      currency?: string;
      discountPct?: number;
      image?: string;
      originalPrice?: number;
      price?: number;
      productId: string;
      rating?: number;
      reviewCount?: number;
      sellerId?: string;
      shopName?: string;
      soldCount?: number;
      title: string;
      url?: string;
    }[];
  } | 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.search
curl -X POST https://api.getanyapi.com/v1/run/tiktok_shop.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"query":"phone case"}'
CampoTipoValor de exemplo
Corpo da requisição
querystring"phone case"Palavra-chave de busca de produtos do TikTok Shop (ex.: wireless earbuds).
countryenumCódigo do país do mercado do TikTok Shop a buscar (ex.: US).
limitinteger3Número máximo de produtos a retornar, respeitado em buscas nos US até 30. Em outros países, e com valores maiores, retorna todos os produtos que o TikTok Shop dá para a consulta, normalmente cerca de 30 e às vezes mais de 50. O preço por chamada é o mesmo nos dois casos.
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `currency`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em um produto que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Resposta
dataobject
data.itemsobject[]Product records matching the search query: id, title, price, sales count, rating, seller, and product URL. Populated whenever the provider has data for the entity.
data.items[].currencypode ser exigidostringISO currency name, e.g. USD.
data.items[].discountPctnumberDiscount off the original price as a percentage, e.g. 10 for 10% off. Omitted when the product is not discounted.
data.items[].imagestringProduct image URL.
data.items[].originalPricenumberPre-discount list price. Omitted when the product is not on sale.
data.items[].pricenumberCurrent sale price.
data.items[].productIdstringTikTok Shop product id. Populated whenever the provider has data for the entity.
data.items[].ratingnumberAverage review score. Omitted when the product has no rating yet.
data.items[].reviewCountpode ser exigidointegerNumber of reviews. Omitted when the lane that served this request does not report it.
data.items[].sellerIdstringTikTok Shop seller id, for joining to the seller's other products.
data.items[].shopNamestringSeller shop name.
data.items[].soldCountintegerUnits sold.
data.items[].titlestringProduct title. Populated whenever the provider has data for the entity.
data.items[].urlstringCanonical product detail page URL. Populated whenever the provider has data for the entity.
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,00095
Preço /mil req.USDUS$ 0,95

Dúvidas frequentes

Sobre o endpoint Buscar da API para TikTok Shop

O endpoint Buscar da AnyAPI para TikTok Shop retorna dados de TikTok Shop em JSON normalizado com uma chamada POST para /v1/run/tiktok_shop.search. Busque produtos do TikTok Shop por palavra-chave em 15 países: preço, vendas, avaliação e dados do vendedor de cada produto, em uma única resposta normalizada. A AnyAPI distribui cada requisição entre 4 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,95 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para TikTok Shop feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 3,0 segundos, em 15.904 chamadas medidas.

Custa a partir de US$ 0,95 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.

Busque produtos do TikTok Shop por palavra-chave em 15 países: preço, vendas, avaliação e dados do vendedor de cada produto, em uma única resposta normalizada. 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, 100,0% das chamadas ao endpoint Buscar da API para TikTok Shop feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 3,0 segundos, em 15.904 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.
Mais para chamar

Outros endpoints de TikTok Shop

Categoriasa partir de US$ 1,20 /mil req.Criadora partir de US$ 5,50 /mil req.Produtoa partir de US$ 0,95 /mil req.Avaliações do produtoa partir de US$ 0,95 /mil req.Sugestões de buscaa partir de US$ 0,95 /mil req.Produtos da lojaa partir de US$ 1,20 /mil req.Vitrine do usuárioa partir de US$ 1,20 /mil req.