API Geoptim v1

Intégrez Geoptim dans tus herramientas

Accede a los proyectos, puntuaciones y resultados de análisis IA de tus clientes directamente a través de nuestra API REST. Integra la visibilidad IA en tus dashboards, informes y flujos de trabajo.

Iniciar sesión Crear una cuenta

Documentación API

Integración simple, respuestas JSON estandarizadas

Autenticación

Añada su token en el encabezado Authorization de cada solicitud:

# Ejemplo cURL
curl -H "Authorization: Bearer ***token***" \
https://geoptim.ai/api/v1/projects.php
POST GET /api/v1/analyze.php - Lanzar un análisis de IA

POST pour lancer une analyse sur un projet. GET pour suivre son statut.

# Lancer une analyse
POST /api/v1/analyze.php
Body: { "project_id": 42, "question_type": "general" }

# Suivre le statut
GET /api/v1/analyze.php?id=123
project_id * question_type: general|ecommerce|local|saas
GET /api/v1/scores.php - Puntuaciones y métricas

Puntuaciones de visibilidad IA, métricas detalladas e historial de evolución.

GET /api/v1/scores.php?project_id=42
GET /api/v1/scores.php?project_id=42&last=1
GET /api/v1/scores.php?scan_id=123
project_id scan_id last=1 límite
GET /api/v1/recommendations.php - Recomendaciones IA

Recomendaciones personalizadas generadas por IA, filtrables por prioridad y categoría.

GET /api/v1/recommendations.php?project_id=42
GET /api/v1/recommendations.php?scan_id=123&priority=critical
GET /api/v1/recommendations.php?scan_id=123&category=ai_visibility
project_id scan_id priority: critical|high|medium|low category: seo|content|technical|ai_visibility
GET /api/v1/projects.php - Lista todos tus proyectos

Paramètres optionnels : limit (max 100), offset, status (active/paused/archived)

GET /api/v1/projects.php?limit=10&offset=0
GET /api/v1/projects.php?id=42
GET /api/v1/scans.php - Escaneos y resultados

Recupere los escaneos de un proyecto o los detalles completos de un escaneo específico.

GET /api/v1/scans.php?project_id=42
GET /api/v1/scans.php?id=123
GET /api/v1/competitors.php - Análisis competitivo

Compara tus proyectos con el benchmark global. Posicionamiento, percentil y deltas vs el promedio.

GET /api/v1/competitors.php
GET /api/v1/competitors.php?project_id=42
Retorna: puntuaciones, benchmark global, percentil, vs_benchmark, sus otros proyectos
GET POST /api/v1/webhooks.php - Webhooks y alertas

Configura webhooks para recibir notificaciones en tiempo real (escaneo completado, fallo, variación de puntuación).

# Lister les webhooks
GET /api/v1/webhooks.php

# Créer un webhook
POST /api/v1/webhooks.php
Body: { "action": "create", "name": "Mon webhook", "url": "https://...", "events": ["scan.completed"] }

# Tester un webhook
POST /api/v1/webhooks.php
Body: { "action": "test", "webhook_id": 1 }
events: scan.completed | scan.failed | score.change
Signature HMAC-SHA256 dans l'en-tête X-Geoptim-Signature
POST GET /api/v1/reports.php - Informes automatizados

Genere reportes completos en formato JSON. Elija las secciones a incluir: puntuaciones, recomendaciones, historial, métricas.

# Générer un rapport
POST /api/v1/reports.php
Body: {
  "project_id": 42,
  "format": "json",
  "include": ["scores", "recommendations", "history", "metrics"]
}

# Récupérer un rapport
GET /api/v1/reports.php?id=5

# Lister mes rapports
GET /api/v1/reports.php?list=1
secciones: puntuaciones | recomendaciones | historial | métricas | confianza
GET /api/v1/stats.php - Estadísticas globales

Vista sintética: número de proyectos, escaneos, puntuación promedio, proyectos principales y evolución.

GET /api/v1/stats.php

Formato de respuesta

{
  "success": true,
  "data": { ... },
  "meta": {
    "timestamp": "2026-02-03T12:00:00+01:00",
    "api_version": "v1",
    "usage": {
      "daily_used": 42,
      "daily_limit": 5000,
      "daily_remaining": 4958
    }
  }
}

Códigos HTTP

200
Éxito
401
No autenticado
429
Límite alcanzado
404
Recurso no encontrado