API Reference

Guía técnica para la integración programática con Prospecta V1. Nuestra API REST permite automatizar búsquedas de leads en tiempo real.

Production Ready

HTTPS Only

Autenticación

Todas las peticiones deben autenticarse mediante un token Bearer en el encabezado Authorization.

Key Prefix

Usa el token completo incluyendo el prefijo pr_live_...

http

Authorization: Bearer pr_live_luk_prou_...

Endpoints Disponibles

GET/api/usage

Balance y Uso

Obtén el balance actual de créditos y el plan activo del workspace.

Respuesta Esperada (200 OK)

{
  "ok": true,
  "data": {
    "credits": {
      "total": 6200,
      "plan": "Pro",
      "included_monthly": 5000
    }
  }
}

Ejemplo de Petición

bash

curl -X GET "https://prospecta.wesolai.com/api/usage" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/api/extract

Nueva Extracción

Inicia un proceso de búsqueda y enriquecimiento de leads.

Respuesta Esperada (200 OK)

{
  "id": "uuid-del-job",
  "status": "pending",
  "message": "Extracción iniciada"
}

Ejemplo de Petición

bash

curl -X POST "https://prospecta.wesolai.com/api/extract" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "SaaS",
    "location": "Madrid",
    "search_mode": "local",
    "max_results": 50
  }'

GET/api/jobs/[id]

Estado del Job

Consulta el progreso y resultados finales de una extracción.

Respuesta Esperada (200 OK)

{
  "status": "completed",
  "valid_leads": 42,
  "results": [...]
}

Ejemplo de Petición

bash

curl -X GET "https://prospecta.wesolai.com/api/jobs/uuid" \
  -H "Authorization: Bearer YOUR_API_KEY"

¿Necesitas ayuda con la integración?

Si tienes problemas técnicos o peticiones especiales para la API, contacta con nuestro equipo de soporte.