// docs hub
Documentação das APIs GeckoAPI
Encontre a API certa, copie uma chamada pronta e integre dados públicos estruturados à sua aplicação. Depois, explore MCP, créditos e buscas que combinam diferentes fontes.
REST endpoint
POST /v1/extract
MCP endpoint
POST /v1/mcp
Conta
GET /v1/me/credits
Autenticação
Bearer ou X-API-Key
APIs suportadas
60
Buscas prontas
5
// escolha seu caminho
O que você quer integrar?
Comece pelas APIs de uma fonte específica ou use uma busca pronta para combinar etapas e receber um arquivo final.
Comece aqui
Documentação das APIs
Escolha uma categoria e encontre instruções, parâmetros, exemplos de chamada e respostas para cada fonte disponível.
Explorar catálogo de APIs →Automação composta
Buscas nos Sites
Combine múltiplas APIs em uma busca pronta e receba o resultado final em JSON ou CSV.
Ver buscas disponíveis →// catálogo de APIs
Encontre a API para o seu caso de uso
Comece pelo mercado que você quer analisar. Depois, escolha entre buscar uma lista, consultar detalhes, coletar avaliações ou obter uma cotação.
PASSO 1
Escolha uma categoria
Encontre as fontes do seu mercado.
PASSO 2
Abra as instruções
Veja entradas, exemplos e resposta.
PASSO 3
Copie e teste
Use o exemplo HTTP ou MCP.
Navegue por mercado
Selecione uma categoria ou pesquise diretamente.
60 APIs encontradas
Precisa combinar fontes? Ver buscas prontas →Produtos e preços
Catálogos, preços, sellers, avaliações e disponibilidade em marketplaces.
Restaurantes e delivery
Lojas, cardápios, itens, avaliações e disponibilidade por região.
Viagens e hospedagem
Hotéis, acomodações, voos, tarifas, avaliações e viagens de ônibus.
Imóveis e veículos
Anúncios, inventário, preços e detalhes de imóveis, carros e motos.
Empresas e leads
Empresas, CNPJs, locais, sites e resultados de busca para prospecção.
Vagas e mercado de trabalho
Vagas abertas, empresas contratantes, localização e trabalho remoto.
Eventos e sinais públicos
Eventos, ingressos e conversas públicas para pesquisa e monitoramento.
Logística e frete
Cotações, prazos e opções de entrega para operações de comércio.
Nenhuma API encontrada
Tente outro termo ou volte para todas as categorias.
// referência da API
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. |
// buscas nos sites
Combine APIs em buscas prontas
Quando o seu caso exige múltiplas etapas ou fontes, use uma busca pronta para acompanhar a execução, estimar créditos e receber o resultado final em JSON ou CSV.
Restaurantes do iFood por região
ID técnico: ifood-restaurants-enriched
Busque restaurantes por palavras-chave e CEPs e receba uma base sem duplicidades com os principais dados de cada loja.
Cardápio e itens de uma loja do iFood
ID técnico: ifood-store-idp-enrichment
Informe a URL de uma loja do iFood e receba o cardápio completo com complementos, observações, preços e dados de cada item.
Empresas do Google Places com presença no iFood e CNPJ
ID técnico: google-places-ifood-cdd-company-enrichment
Encontre empresas por localização, valide a presença no iFood e receba uma base enriquecida com CNPJ e dados empresariais.
Imobiliárias do Zapimóveis com site, contatos e CNPJ
ID técnico: zapimoveis-google-website-cdd-imobiliaria-enrichment
Busque imobiliárias por cidade, encontre seus sites oficiais e receba contatos, dados da empresa e CNPJ enriquecido.
Vendedores do Mercado Livre com site, contatos e CNPJ
ID técnico: mercadolivre-google-website-cdd-seller-enrichment
Encontre vendedores por categoria, valide seus sites oficiais com IA e receba contatos e dados empresariais para prospecção.
Pronto para integrar?
Use as páginas de API e busca nos sites para copiar requests, entender o consumo de créditos e validar o formato dos dados antes de ir para produção.