← Docs

Referência API

Autenticação

Todas as rotas exigem header X-API-Key.

POST /v1/discover

Roda os 7 agentes contra os marketplaces escolhidos. Retorna top-N produtos.

Body

{
  "niche": "string (1-100 chars)",
  "platforms": ["shopee" | "ml" | "amazon" | "aliexpress" | "awin"],
  "max_keywords": 8,        // opcional, default 8
  "max_results": 30,        // opcional, default 30
  "filters_override": {     // opcional
    "min_commission_rate": 0.05,
    "min_sales": 50,
    "min_rating": 4.0
  }
}

GET /v1/runs/{request_id}

Auditoria de uma busca. Retorna stats, drop rate, warnings, atores chamados.

GET /v1/usage

Consumo do mês corrente vs quota do plano.

Errors

• 401 — API key inválida
• 429 — quota mensal excedida
• 503 — todos os actors falharam (rede/upstream)