# TikTok Shop (dados públicos)

> TikTok Shop (dados públicos): Produtos, lojas, avaliações e criadores do TikTok Shop.

URL: https://apicultura.app/ferramentas/tiktok-shop/
Atualizado em 05/11/2026 (2026-11-05).

## O que é TikTok Shop (dados públicos) na APIcultura

Acesse TikTok Shop (dados públicos) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Produtos, lojas, avaliações e criadores do TikTok Shop. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Comércio e preços](/catalogo/?cat=comercio). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `tiktok-shop-buscar` | Buscar produtos | R$ 0,02 | `POST /v1/call/tiktok-shop-buscar` |
| `tiktok-shop-produto` | Detalhe do produto | R$ 0,02 | `POST /v1/call/tiktok-shop-produto` |
| `tiktok-shop-avaliacoes` | Avaliações do produto | R$ 0,01 | `POST /v1/call/tiktok-shop-avaliacoes` |
| `tiktok-shop-loja` | Produtos de uma loja | R$ 0,02 | `POST /v1/call/tiktok-shop-loja` |
| `tiktok-shop-sugestoes` | Sugestões de busca | R$ 0,02 | `POST /v1/call/tiktok-shop-sugestoes` |
| `tiktok-shop-criador` | Criador do TikTok Shop | R$ 0,05 | `POST /v1/call/tiktok-shop-criador` |

### Buscar produtos (`tiktok-shop-buscar`)

Busca produtos no TikTok Shop. Preço: R$ 0,02 por chamada.

- `country` (string, opcional, padrão "US")
- `limit` (integer, opcional, mín. 1, máx. 10), ex.: `3`
- `query` (string, obrigatório), ex.: `phone case`

### Schema de entrada de tiktok-shop-buscar

```json
{
  "required": [
    "query"
  ],
  "properties": {
    "country": {
      "type": "string",
      "maxLength": 2000
    },
    "limit": {
      "type": "number"
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Detalhe do produto (`tiktok-shop-produto`)

Detalhes de um produto do TikTok Shop. Preço: R$ 0,02 por chamada.

- `region` (string, opcional)
- `url` (string, obrigatório), ex.: `https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799`

### Schema de entrada de tiktok-shop-produto

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "region": {
      "type": "string",
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Avaliações do produto (`tiktok-shop-avaliacoes`)

Avaliações de um produto do TikTok Shop. Preço: R$ 0,01 por chamada.

- `page` (integer, opcional, padrão 1, mín. 1)
- `region` (string, opcional)
- `url` (string, obrigatório), ex.: `https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516`

### Schema de entrada de tiktok-shop-avaliacoes

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "page": {
      "type": "number"
    },
    "region": {
      "type": "string",
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Produtos de uma loja (`tiktok-shop-loja`)

Produtos de uma loja do TikTok Shop. Preço: R$ 0,02 por chamada.

- `region` (string, opcional)
- `sortBy` (string, opcional, padrão "top")
- `url` (string, obrigatório), ex.: `https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079`

### Schema de entrada de tiktok-shop-loja

```json
{
  "required": [
    "url"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "maxLength": 2000
    },
    "region": {
      "type": "string",
      "maxLength": 2000
    },
    "sortBy": {
      "type": "string",
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Sugestões de busca (`tiktok-shop-sugestoes`)

Sugestões de busca do TikTok Shop. Preço: R$ 0,02 por chamada.

- `country` (string, opcional, padrão "US"), ex.: `US`
- `language` (string, opcional, padrão "en-US")
- `query` (string, obrigatório), ex.: `ashwagandha gummies`

### Schema de entrada de tiktok-shop-sugestoes

```json
{
  "required": [
    "query"
  ],
  "properties": {
    "country": {
      "type": "string",
      "maxLength": 2000
    },
    "language": {
      "type": "string",
      "maxLength": 2000
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Criador do TikTok Shop (`tiktok-shop-criador`)

Dados de um criador afiliado do TikTok Shop. Preço: R$ 0,05 por chamada.

- `handle` (string, obrigatório), ex.: `golinutrition`
- `region` (string, opcional, padrão "us")

### Schema de entrada de tiktok-shop-criador

```json
{
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "maxLength": 2000
    },
    "region": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "tiktok-shop-buscar", "input": {"limit":3,"query":"phone case"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/tiktok-shop-buscar \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"query":"phone case"}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 0,02 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Experimente

Teste no playground interativo: [TikTok Shop (dados públicos) no playground](/ferramentas/ferramenta.html?slug=tiktok-shop). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** TikTok Shop (dados públicos) é marca de seus respectivos donos, citada apenas para identificar a integração.