API REST

Referencia de API

Acceso HTTP directo a todas las características de Baseline Labs. Autentica con tu clave de API y llama desde cualquier lenguaje.

URL Base

https://baselinelabs.ai/api/

Autentica con X-API-Key: bl_your_key encabezado en cada solicitud.

Proyectos

GET /api/geo/saves

Lista todos tus proyectos.

{
  "saves": [
    { "id": 42, "name": "My Brand", "url": "https://mybrand.com" }
  ]
}

POST /api/geo/saves

Crea un nuevo proyecto.

{ "name": "My Brand", "url": "https://mybrand.com" }

Búsqueda

POST /api/geo/search

Ejecuta una búsqueda en Google, GPT, Perplexity, Gemini, Google AI Mode, Claude y DeepSeek. Cuesta créditos.

{
  "save_id": 42,
  "queries": ["best project management tools", "top PM software 2026"]
}

Devuelve un ID de búsqueda. Consulta los resultados:

GET /api/geo/search/{search_id}

Obtén los resultados de búsqueda una vez que se complete el procesamiento.

Reportes de Visibilidad

GET /api/geo/reports/templates

Lista tus plantillas de reporte.

POST /api/geo/reports/run

Ejecuta un reporte de visibilidad desde una plantilla. Cuesta créditos.

{ "template_id": 12 }

GET /api/geo/reports/{report_id}

Obtén los resultados del reporte incluyendo rankings por consulta.

Menciones de Marca

POST /api/geo/mentions/scan

Crea un escaneo de menciones de marca. Cuesta créditos.

{ "save_id": 42, "brand_name": "My Brand" }

GET /api/geo/mentions/{scan_id}

Obtén los resultados del escaneo y registros de menciones individuales.

Schema.org

POST /api/geo/schema/generate

Genera schema.org JSON-LD para cualquier URL usando inferencia GPU.

{ "url": "https://example.com/page" }

Respuesta:

{
  "url": "https://example.com/page",
  "schema_url": "https://schema.baselinelabs.ai/abc123.json",
  "cached": true,
  "inference_ms": 12
}

GET /api/geo/schema/status/{job_id}

Verifica el estado del trabajo de generación de esquema asincrónico (para trabajos >5s).

Respuestas de Error

Todos los errores devuelven JSON con un detail campo.

401 Clave de API incorrecta o faltante

402 Créditos insuficientes

429 Limitado por velocidad

404 Recurso no encontrado