SHPE Shopee.com.br

Shopee Scraper API para Produtos, Preços e Estoque

A GeckoAPI transforma páginas públicas da Shopee Brasil em JSON para consultar produtos, preços, estoque, sellers e resultados de busca. Ela atende monitoramento e inteligência de catálogo; para operar uma loja autorizada ou gerar links e comissões de afiliado, use as APIs oficiais correspondentes.

GeckoAPI é uma API independente e não é afiliada, patrocinada ou endossada por Shopee.com.br.

Não precisa de cartão de crédito.

API Shopee scraper Shopee web scraping Shopee extrair dados Shopee monitoramento de preços Shopee dados Shopee

// escolha_da_integracao

Qual API da Shopee você precisa?

Open Platform, Affiliate API e dados públicos resolvem trabalhos diferentes. Escolha pelo resultado e pela autorização necessária, não apenas pela palavra “API”.

O que é

Uma camada independente para transformar páginas públicas da Shopee Brasil em JSON estruturado para catálogo, pricing, monitoramento, BI e agentes.

O que não é

Uma API para operar sua loja, acessar pedidos privados, gerar comissão ou substituir as regras dos programas oficiais da Shopee.

Opção Use quando Autenticação Resultado principal Referência
Shopee Open Platform Operar uma loja autorizada, integrar pedidos, produtos e processos ligados à conta do seller. Aplicação e autorização conforme o programa oficial. Operações e dados de conta permitidos pela plataforma. Open Platform
Shopee Affiliate Open API Fluxos de afiliado, como catálogo elegível, links rastreáveis e atribuição/comissão conforme o programa. AppId e secret do programa de afiliados. Recursos próprios do programa e do contrato de afiliado. Affiliate Explorer
GeckoAPI Extract Consultar páginas públicas de produto e busca para pricing, catálogo, estoque, sellers e inteligência competitiva. Chave da GeckoAPI enviada pelo seu backend. PDP e PLP da Shopee Brasil em JSON estruturado. Ver PDP

// cobertura_de_endpoints

Endpoints de Shopee disponíveis

Cada linha leva à documentação canônica com entradas, schema e exemplo de resposta completos.

Endpoint Entrada Campos principais Paginação Créditos
Shopee PDP URL pública de uma página de produto da Shopee Brasil. Produto, IDs, seller, loja oficial/verificada, preço quando exposto, estoque, vendas, avaliações, variações, mídia e frete. Não se aplica: uma página de produto por chamada. Consulte o custo vigente na documentação do endpoint.
Shopee PLP Keyword ou URL pública /search com o parâmetro keyword. Itens, preço e faixa, desconto, estoque, vendas, seller, localização, avaliação, imagens e sinais promocionais. O parâmetro page não é aceito no endpoint atual; trate a chamada como um snapshot da busca. 25 créditos por request, conforme a documentação atual.

// exemplos_copiaveis

curl, Python e JavaScript

Troque a URL ou keyword e mantenha sua chave apenas no servidor. Nunca exponha a credencial em JavaScript enviado ao navegador.

curl · busca PLP
curl -X POST "https://api.geckoapi.com.br/v1/extract" \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "shopee.com.br",
    "type": "plp",
    "keyword": "notebook gamer"
  }'
Python · produto PDP
import requests

response = requests.post(
    "https://api.geckoapi.com.br/v1/extract",
    headers={"Authorization": "Bearer SUA_CHAVE"},
    json={
        "target": "shopee.com.br",
        "type": "pdp",
        "url": "https://shopee.com.br/product/1157985386/23897901346",
    },
    timeout=90,
)
response.raise_for_status()
product = response.json()["data"]
print(product["name"], product["stock"])
JavaScript · busca PLP
const response = await fetch(
  "https://api.geckoapi.com.br/v1/extract",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer SUA_CHAVE",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      target: "shopee.com.br",
      type: "plp",
      keyword: "notebook gamer",
    }),
  },
);

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { data } = await response.json();
console.log(data.query, data.items);

// resposta_real_redigida

Como o JSON chega

Exemplo reduzido a partir do contrato publicado. IDs e valores são ilustrativos; confira o schema completo antes de tipar sua integração.

shopee-response.json
{
  "requestId": "66666666-1111-4111-8111-666666666666",
  "executionId": "66666666-2222-4222-8222-666666666666",
  "data": {
    "name": "Relógio Technos Executive",
    "itemId": "23897901346",
    "shopId": "1157985386",
    "sellerName": "Zilla Relógios",
    "sellerLocation": "Paiçandu, Paraná",
    "sellerRating": 4.931507,
    "sellerIsOfficialShop": false,
    "sellerIsShopeeVerified": false,
    "currency": "BRL",
    "availability": "InStock",
    "stock": 10,
    "soldCount": 124,
    "aggregateRating": {
      "ratingValue": 4.96875,
      "reviewCount": 32
    },
    "tierVariations": [
      {
        "name": "Cor",
        "options": ["Preto", "Marrom"]
      }
    ],
    "shippingChannels": [
      {
        "name": "Entrega Padrão",
        "shippingFee": 0,
        "estimatedDeliveryTimeMinDays": 2,
        "estimatedDeliveryTimeMaxDays": 7
      }
    ]
  }
}

// campos_essenciais

Definições dos campos

data.itemId / data.shopId
IDs públicos do item e da loja usados para identificar e deduplicar registros.
data.price / data.priceMin / data.priceMax
Preço ou faixa observada; a presença depende do tipo de página e do conteúdo público.
data.stock / data.availability
Quantidade e sinal de disponibilidade quando expostos pela página consultada.
data.sellerName / data.sellerRating
Nome público do seller e sinal agregado de avaliação da loja.
data.sellerIsOfficialShop
Indicador público de loja oficial; não significa vínculo ou validação pela GeckoAPI.
data.tierVariations[]
Eixos de variação e opções, como cor ou tamanho, quando presentes.
data.aggregateRating
Nota agregada, contagem de avaliações e melhor nota quando disponíveis.
data.shippingChannels[]
Modalidade, valor e janela estimada de entrega expostos para a consulta.

// workflow_recomendado

Busca para descobrir; PDP para enriquecer

Comece com um snapshot da busca, escolha os produtos relevantes e aprofunde somente o que alimenta uma decisão. Esse desenho melhora cobertura e evita consultas sem valor.

  1. 01

    Use PLP por keyword para observar o conjunto de produtos e sellers exibidos na busca da Shopee Brasil.

  2. 02

    Normalize itemId, shopId, URL e variações antes de deduplicar os registros.

  3. 03

    Priorize os itens relevantes e consulte PDP para enriquecer seller, estoque, avaliações, mídia e frete.

  4. 04

    Salve snapshots com executionId e horário; a resposta representa a página observada naquela execução.

  5. 05

    Compare os snapshots no seu banco e aplique regras de alerta para preço, estoque, seller e sortimento.

  6. 06

    Meça créditos, latência e taxa de resposta antes de aumentar a frequência ou o número de keywords.

// limites_e_operacao

O que planejar antes de produção

O contrato documentado é a fonte de verdade. Campos públicos podem não existir em todos os itens, e a página de origem pode mudar entre duas coletas.

Tema Comportamento Como tratar
Autenticação A GeckoAPI aceita uma chave no header de autorização. Execute no backend ou em função server-side; nunca envie sua chave em JavaScript público.
Latência PDP e PLP podem levar até 1 minuto em algumas execuções. Use timeout de pelo menos 90 segundos e apresente estado de processamento na sua aplicação.
Paginação PLP O parâmetro page não é suportado pelo contrato Shopee PLP atual. Não programe loop por page. Consuma o snapshot retornado e acompanhe a documentação para mudanças.
Locale e moeda Os endpoints desta página miram shopee.com.br e normalizam valores em BRL. Não reutilize regras de Brasil para outros países sem endpoint e contrato específicos.
Campos opcionais Preço, estoque, frete, variações, seller e avaliações dependem do conteúdo exposto. Use tipos opcionais e diferencie null, lista vazia e entidade não encontrada.
Entidade ausente Uma entidade não encontrada pode retornar notFound: true e data: null. Trate esse estado explicitamente e não o confunda com falha de parsing.
Retries Rede e origem podem falhar transitoriamente; erros 4xx indicam entrada ou autenticação. Use backoff com jitter e limite de tentativas; não repita 4xx sem corrigir o request.
Créditos Shopee PLP custa 25 créditos por request na documentação atual; outros custos podem variar. Calcule o orçamento por keyword e valide o custo vigente antes de ampliar a rotina.

Uso responsável e independência

A GeckoAPI estrutura dados de páginas públicas e não é afiliada, patrocinada ou endossada por Shopee. Use apenas dados necessários ao seu caso, proteja chaves e resultados, respeite contratos, políticas da plataforma, privacidade e a legislação aplicável. Esta página não é aconselhamento jurídico.

// perguntas_frequentes

Perguntas sobre a API de Shopee

Qual API da Shopee eu devo usar? +

Use Open Platform para operar uma conta autorizada, Affiliate Open API para casos do programa de afiliados e GeckoAPI para estruturar páginas públicas de produto e busca.

A GeckoAPI é afiliada à Shopee? +

Não. A GeckoAPI é independente e não é afiliada, patrocinada ou endossada pela Shopee.

Posso buscar produtos por palavra-chave? +

Sim. Shopee PLP aceita keyword ou uma URL pública /search com keyword. O parâmetro page não é suportado no contrato atual.

Quais dados a Shopee PDP retorna? +

A PDP pode incluir produto, IDs, seller, localização, indicadores de loja, estoque, vendas, avaliações, variações, imagens, vídeos, atributos e frete, conforme a página expuser.

Quanto tempo uma chamada pode levar? +

Em algumas execuções, Shopee PDP e PLP podem levar até 1 minuto. Configure timeout adequado e aguarde a conclusão.

Quanto custa a Shopee PLP? +

A documentação atual informa 25 créditos por request para Shopee PLP. Confirme o valor vigente na página do endpoint antes de dimensionar volume.

A API mantém histórico de preços e estoque? +

Não automaticamente. Salve snapshots no seu banco e compare as execuções para criar histórico, alertas e métricas.

// para_quem_serve

Para quem serve

Monitoramento de preços

Acompanhe preços, promoções e mudanças de concorrentes na Shopee.

Scraping de busca

Extraia listagens por keyword, página e ordenação para montar bases de mercado.

Estoque e sellers

Monitore disponibilidade, vendedores, lojas oficiais e variações do produto.

Catálogo enriquecido

Adicione dados estruturados de produtos ao seu sistema.

Dashboards de pricing

Crie painéis de preço, disponibilidade e sortimento com dados recorrentes.

Agentes de IA

Responda perguntas sobre produtos com dados verificáveis.

// como_funciona

Como funciona

01

Crie sua conta

Acesse o dashboard e gere sua chave de API.

02

Chame a API

POST /v1/extract com a URL, target e tipo no body.

03

Receba JSON

Dados estruturados, padronizados e prontos para uso.

exemplo.sh
$ curl -X POST \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{"url":"https://...","target":"shopee.com.br","type":"pdp"}' \
https://api.geckoapi.com.br/v1/extract

// integracao_ia

Integre com IA (MCP)

Conecte agentes de IA à GeckoAPI e seu chatbot responde com dados reais de Shopee.com.br.

// exemplos de perguntas que seu agente pode responder:

"Quais sao os notebooks gamer mais baratos nessa busca?"

"Mostre os primeiros itens desta pesquisa da Shopee."

"Quais sellers oficiais aparecem para essa keyword?"

"Essa busca ainda tem mais paginas de resultados?"

Fluxo: Chatbot → Agente MCP → GeckoAPI → Resposta com dados

100 créditos iniciais

Comece a usar a API de Shopee.com.br

Crie sua conta e comece grátis. Sem cartão necessário.