Integre Luminara AI en su aplicación con nuestra potente API REST. Integración sencilla con solicitudes HTTP estándar.
Integre Luminara AI con simples llamadas fetch(). No se necesitan paquetes adicionales — simplemente use la API REST con su API Key.
const API_KEY = 'lum_xxxxxxxxxxxxx';
const BASE_URL = 'https://api.luminara-ai.de';
const headers = {
'X-API-Key': API_KEY,
'Content-Type': 'application/json',
};
// List your stores
const stores = await fetch(`${BASE_URL}/api/stores`, { headers })
.then(res => res.json());
// Get visibility status
const status = await fetch(`${BASE_URL}/api/visibility-addon/status`, { headers })
.then(res => res.json());
console.log(`AI Visibility Score: ${status.latestScore}`);
// List tracked keywords
const keywords = await fetch(`${BASE_URL}/api/visibility-addon/keywords`, { headers })
.then(res => res.json());Regístrese y cree una API Key en su panel de control.
Envíe sus primeras solicitudes API con su API Key.
Integre las respuestas de la API en su aplicación.
Todas las solicitudes API requieren una API Key válida en el encabezado Authorization.
X-API-Key: lum_xxxxxxxxxxxxxNota de seguridad: Nunca comparta su API Key públicamente. Use variables de entorno para el almacenamiento seguro.
| Método | Endpoint | Descripción | Auth |
|---|---|---|---|
| GET | /api/stores | Listar todas las tiendas | Required |
| GET | /api/products | Obtener lista de todos los productos | Required |
| POST | /api/products | Crear un nuevo producto | Required |
| PUT | /api/products/:id | Actualizar un producto | Required |
| DELETE | /api/products/:id | Eliminar un producto | Required |
| GET | /api/services | Obtener lista de todos los servicios | Required |
| POST | /api/validate | Realizar validación de esquema | Required |
| GET | /api/visibility-addon/status | Estado y puntuación de visibilidad IA | Required |
| GET | /api/visibility-addon/keywords | Listar palabras clave rastreadas | Required |
| POST | /api/stores/:storeId/scan | Iniciar escaneo del sitio web | Required |
| GET | /api/stores/:storeId/scan-results | Obtener resultados del escaneo | Required |
| GET | /api/visibility-addon/citations | Listar citas de IA | Required |
| GET | /api/visibility-addon/competitors | Obtener competidores y rankings | Required |
| GET | /api/gsc/analytics | Datos de Google Search Console | Required |
| GET | /api/content/recommendations | Obtener recomendaciones de contenido | Required |
| GET | /api/sentiment/overview | Resumen de análisis de sentimiento | Required |
La información de límite de solicitudes se devuelve en los encabezados de respuesta: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.
Pruebe todos los endpoints directamente en la interfaz Swagger interactiva. Más de 50 endpoints con esquemas, ejemplos y función de prueba.
Abrir Swagger UI# List all products
curl -X GET "https://api.luminara-ai.de/api/products?storeId=YOUR_STORE_ID" \
-H "X-API-Key: lum_xxxxxxxxxxxxx"
# Start a website scan
curl -X POST "https://api.luminara-ai.de/api/stores/YOUR_STORE_ID/scan" \
-H "X-API-Key: lum_xxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"fullCrawl": true}'
# Get visibility score
curl -X GET "https://api.luminara-ai.de/api/visibility-addon/status" \
-H "X-API-Key: lum_xxxxxxxxxxxxx"const API_KEY = 'lum_xxxxxxxxxxxxx';
const BASE_URL = 'https://api.luminara-ai.de';
const headers = {
'X-API-Key': API_KEY,
'Content-Type': 'application/json',
};
// List products
const products = await fetch(
`${BASE_URL}/api/products?storeId=YOUR_STORE_ID`,
{ headers }
).then(res => res.json());
// Create a product
await fetch(`${BASE_URL}/api/products`, {
method: 'POST',
headers,
body: JSON.stringify({
storeId: 'YOUR_STORE_ID',
title: 'Premium Coffee Maker',
brand: 'BrewMaster',
category: 'Kitchen Appliances',
}),
});
// Start a scan
await fetch(`${BASE_URL}/api/stores/YOUR_STORE_ID/scan`, {
method: 'POST',
headers,
body: JSON.stringify({ fullCrawl: true }),
});
// Error handling
const res = await fetch(`${BASE_URL}/api/stores/YOUR_STORE_ID`, { headers });
if (res.status === 429) {
const retryAfter = res.headers.get('Retry-After');
console.log(`Rate limited. Retry after ${retryAfter}s`);
}import requests
API_KEY = 'lum_xxxxxxxxxxxxx'
BASE_URL = 'https://api.luminara-ai.de'
headers = {'X-API-Key': API_KEY}
# List stores
stores = requests.get(f'{BASE_URL}/api/stores', headers=headers).json()
# Get visibility status
status = requests.get(f'{BASE_URL}/api/visibility-addon/status', headers=headers).json()
print(f"Score: {status['latestScore']}")
# Add a keyword to track
requests.post(
f'{BASE_URL}/api/visibility-addon/keywords',
headers={**headers, 'Content-Type': 'application/json'},
json={'keyword': 'best coffee maker'}
)Nuestro soporte para desarrolladores le ayudará con la integración.
Contactar soporte