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.
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.
// escolha_da_integracao
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
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
Troque a URL ou keyword e mantenha sua chave apenas no servidor. Nunca exponha a credencial em JavaScript enviado ao navegador.
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"
}' 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"]) 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
Exemplo reduzido a partir do contrato publicado. IDs e valores são ilustrativos; confira o schema completo antes de tipar sua integração.
{
"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
// workflow_recomendado
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.
Use PLP por keyword para observar o conjunto de produtos e sellers exibidos na busca da Shopee Brasil.
Normalize itemId, shopId, URL e variações antes de deduplicar os registros.
Priorize os itens relevantes e consulte PDP para enriquecer seller, estoque, avaliações, mídia e frete.
Salve snapshots com executionId e horário; a resposta representa a página observada naquela execução.
Compare os snapshots no seu banco e aplique regras de alerta para preço, estoque, seller e sortimento.
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 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. |
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.
// continue_a_implementacao
Escolha da integração, implementação, campos, monitoramento e FAQ.
Entradas, schema completo, exemplo e limitações da página de produto.
Busca por keyword ou URL, campos retornados e custo vigente.
Arquitetura multi-marketplace para descoberta, enriquecimento e alertas.
Planos, créditos iniciais e orientação para dimensionar consumo.
Princípios para coleta, armazenamento e aplicação dos dados.
// fontes_e_verificacao
Última verificação desta página: .
Portal oficial para integrações de plataforma e operações autorizadas de seller.
Explorer oficial da API ligada ao programa de afiliados no Brasil.
// perguntas_frequentes
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.
Não. A GeckoAPI é independente e não é afiliada, patrocinada ou endossada pela Shopee.
Sim. Shopee PLP aceita keyword ou uma URL pública /search com keyword. O parâmetro page não é suportado no contrato atual.
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.
Em algumas execuções, Shopee PDP e PLP podem levar até 1 minuto. Configure timeout adequado e aguarde a conclusão.
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.
Não automaticamente. Salve snapshots no seu banco e compare as execuções para criar histórico, alertas e métricas.
// para_quem_serve
Acompanhe preços, promoções e mudanças de concorrentes na Shopee.
Extraia listagens por keyword, página e ordenação para montar bases de mercado.
Monitore disponibilidade, vendedores, lojas oficiais e variações do produto.
Adicione dados estruturados de produtos ao seu sistema.
Crie painéis de preço, disponibilidade e sortimento com dados recorrentes.
Responda perguntas sobre produtos com dados verificáveis.
// como_funciona
Acesse o dashboard e gere sua chave de API.
POST /v1/extract com a URL, target e tipo no body.
Dados estruturados, padronizados e prontos para uso.
// integracao_ia
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
Crie sua conta e comece grátis. Sem cartão necessário.