// docs hub

Documentação do POST /v1/extract

Guia técnico orientado a integração para todas as APIs suportadas hoje. Cada página mostra contrato de entrada, exemplo de request, schema de resposta, exemplo de output sem valores nulos e referência completa de campos.

Endpoint

POST /v1/extract

Base URL

https://api.geckoapi.com.br

Autenticação

Authorization: Bearer SUA_CHAVE

APIs suportadas

11

Fontes suportadas no momento

Amazon (2) Booking (2) Catho (2) Mercado Livre (3) Webmotors (2)

Esta documentação cobre apenas APIs com suporte ativo no backend atual.

Erros comuns do endpoint

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.
500 WORKER_ERROR / INTERNAL_ERROR Falha interna no worker ou no gateway.
1000 req grátis/mês

Pronto para integrar?

Use as páginas de API para copiar requests completos e validar seu payload antes de ir para produção.