Pular para o conteúdo
EN Começar grátis

// docs hub

Documentação de Extract, Conta, Workflows e MCP

Guias técnicos e operacionais para integrar as APIs da GeckoAPI, consultar créditos, executar workflows prontos no dashboard ou via API key e entender os arquivos gerados por cada fluxo suportado hoje.

REST endpoint

POST /v1/extract

MCP endpoint

POST /v1/mcp

Conta

GET /v1/me/credits

Autenticação

Bearer ou X-API-Key

Endpoints documentados

94

Workflows suportados

2

Catálogo de APIs

Encontre uma fonte e escolha o que consultar.

Abrir catálogo completo

49 fontes · 94 operações

123Milhas123milhas.com1 operação
Sobre esta fonte
Adidasadidas.com.br2 operações
Airbnbairbnb.com.br2 operações
Sobre esta fonte
AliExpressaliexpress.com2 operações
Sobre esta fonte
Amazonamazon.com.br2 operações
Sobre esta fonte
App Storeapps.apple.com1 operação
Sobre esta fonte
Azulvoeazul.com.br1 operação
Sobre esta fonte
Bookingbooking.com.br3 operações
Sobre esta fonte
Brastempbrastemp.com.br2 operações
Sobre esta fonte
Casa dos Dadoscasadosdados.com.br1 operação
Sobre esta fonte
Casas Bahiacasasbahia.com.br3 operações
Sobre esta fonte
Cathocatho.com.br2 operações
Sobre esta fonte
Centaurocentauro.com.br2 operações
Sobre esta fonte
Chaves na Mãochavesnamao.com.br2 operações
Sobre esta fonte
ClickBusclickbus.com.br1 operação
Sobre esta fonte
Correioscorreios.com.br1 operação
Sobre esta fonte
Dafitidafiti.com.br2 operações
Sobre esta fonte
Decolardecolar.com1 operação
Sobre esta fonte
Electroluxloja.electrolux.com.br2 operações
Sobre esta fonte
Glassdoorglassdoor.com.br2 operações
Sobre esta fonte
GOLvoegol.com.br1 operação
Sobre esta fonte
Googlegoogle.com2 operações
Sobre esta fonte
Hoteis.comhoteis.com3 operações
Sobre esta fonte
Imovelwebimovelweb.com.br2 operações
Sobre esta fonte
KAYAKkayak.com.br1 operação
Sobre esta fonte
LATAMlatamairlines.com1 operação
Sobre esta fonte
Leroy Merlinleroymerlin.com.br2 operações
Sobre esta fonte
Magalumagazineluiza.com.br3 operações
Sobre esta fonte
MaxMilhasmaxmilhas.com.br1 operação
Sobre esta fonte
Mercado Livremercadolivre.com.br3 operações
Sobre esta fonte
Netshoesnetshoes.com.br2 operações
Sobre esta fonte
OLXolx.com.br2 operações
Sobre esta fonte
Pede.aipede.ai2 operações
Portal Zukportalzuk.com.br2 operações
Sobre esta fonte
Reclame AQUIreclameaqui.com.br4 operações
Sobre esta fonte
Samsungsamsung.com.br2 operações
Sobre esta fonte
SHEINshein.com2 operações
Sobre esta fonte
Shopeeshopee.com.br2 operações
Sobre esta fonte
Smilessmiles.com.br1 operação
Sobre esta fonte
Symplasympla.com.br2 operações
Sobre esta fonte
Temutemu.com2 operações
Sobre esta fonte
TikTok Shoptiktok.com2 operações
Sobre esta fonte
Trip.comtrip.com1 operação
Sobre esta fonte
Tripadvisortripadvisor.com.br4 operações
Sobre esta fonte
Trivagotrivago.com.br2 operações
Sobre esta fonte
VivaRealvivareal.com.br3 operações
Sobre esta fonte
Webmotorswebmotors.com.br2 operações
Sobre esta fonte
Xx.com1 operação
Zapimoveiszapimoveis.com.br2 operações
Sobre esta fonte

Custos padrão em créditos. As condições da sua conta aparecem no sandbox.

MCP hospedado

Guia do endpoint remoto `/v1/mcp`

Veja autenticação, naming de tools, `initialize`, `tools/list`, `tools/call`, formato de sucesso/erro e a limitação da v1 para chaves estáticas.

Conta autenticada

Guia de créditos e consumo recente

Consulte o saldo atual de créditos e o total consumido nas últimas 24 horas, 7 dias e 30 dias usando token do dashboard ou API key.

Workflows no dashboard

Guia dos workflows prontos da GeckoAPI

Entenda o que é um workflow, como configurar uma execução no dashboard ou via API key, como a estimativa de créditos funciona e quais dados saem em JSON ou CSV em cada template disponível.

Workflows disponíveis

Zapimoveis -> Google -> Website -> Casa dos Dados

zapimoveis-google-website-cdd-imobiliaria-enrichment

5 etapas

Parte de anuncios no Zapimoveis, consolida imobiliarias unicas, encontra o site oficial, coleta contatos e entrega um artifact com dados da empresa e CNPJ enriquecido.

json csv

Mercado Livre -> Google -> AI -> Website -> Casa dos Dados

mercadolivre-google-website-cdd-seller-enrichment

6 etapas

Parte de produtos no Mercado Livre, consolida vendedores unicos, usa uma escada de buscas no Google, valida sites oficiais com IA e pode usar diretorios de CNPJ como fallback para descobrir empresa e contatos.

json csv

Erros comuns do endpoint

Quando a entidade consultada não existe na origem, o endpoint retorna 200 com data: null e notFound: true. A tabela abaixo cobre apenas respostas de erro.

Status errorCode Quando acontece
400 INVALID_PAYLOAD JSON inválido ou violação das regras de validação do payload.
401 UNAUTHORIZED Header Authorization ausente ou token/chave inválida.
402 INSUFFICIENT_CREDITS Saldo de créditos insuficiente para a API solicitada.
403 FORBIDDEN Usuário sem acesso ou API temporariamente desabilitada.
409 EXECUTION_CONFLICT executionId conflita com uma execução em estado incompatível.
429 RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS Limite de taxa ou limite de requisições em voo excedido.
5xx UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.
100 créditos iniciais

Pronto para integrar?

Use as páginas de API e workflows para copiar requests, entender o consumo de créditos e validar o formato do arquivo final antes de ir para produção.

Ir para o DashboardVer exemplos de uso