API Documentation

Integre o Prospector nos seus sistemas. Busque leads, exporte dados e automatize sua prospecção.

Base URL: https://prospector.ghhagenciadigital.com.br/api

Autenticação

Todas as requisições devem incluir o userId no body da requisição. O userId é o identificador único do usuário no Supabase.

// Exemplo de requisição
const response = await fetch('/api/search', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    userId: 'seu-user-id',
    segment: 'restaurantes',
    city: 'São Paulo, SP',
    limit: 20,
  }),
})

POST/api/search

Iniciar uma busca de leads no Google Maps

Request Body

{
  "userId": "uuid-do-usuario",
  "segment": "restaurantes",
  "city": "São Paulo, SP",
  "limit": 20
}

Response

{
  "success": true,
  "runId": "apify-run-id",
  "segment": "restaurantes",
  "city": "São Paulo, SP"
}

GET/api/search/results?runId=xxx

Buscar resultados de uma busca em andamento

Response

{
  "status": "succeeded",
  "leads": [
    {
      "name": "Restaurante Bom Sabor",
      "city": "São Paulo, SP",
      "rating": 4.5,
      "phone": "+5511999999999",
      "website": "https://bomsabor.com.br",
      "address": "Rua Augusta, 1000"
    }
  ]
}

POST/api/export

Exportar leads como CSV

Request Body

{
  "userId": "uuid-do-usuario",
  "format": "csv",
  "filters": {
    "temperature": "quente"
  }
}

Response

CSV file download

Rate Limits

POST /api/search10 req/min

POST /api/checkout5 req/min

POST /api/export5 req/min

Outras rotas30 req/min

Começar Agora