Integra Luminara AI nella tua applicazione con la nostra potente API REST. Integrazione semplice con richieste HTTP standard.
Integra Luminara AI con semplici chiamate fetch(). Nessun pacchetto aggiuntivo necessario — usa semplicemente l'API REST con la tua 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());Registrati e crea una API Key nella tua dashboard.
Invia le tue prime richieste API con la tua API Key.
Integra le risposte API nella tua applicazione.
Tutte le richieste API richiedono una API Key valida nell'header Authorization.
X-API-Key: lum_xxxxxxxxxxxxxNota di sicurezza: Non condividere mai la tua API Key pubblicamente. Utilizza le variabili d'ambiente per l'archiviazione sicura.
| Metodo | Endpoint | Descrizione | Auth |
|---|---|---|---|
| GET | /api/stores | Elencare tutti gli store | Required |
| GET | /api/products | Recupera elenco di tutti i prodotti | Required |
| POST | /api/products | Crea un nuovo prodotto | Required |
| PUT | /api/products/:id | Aggiorna un prodotto | Required |
| DELETE | /api/products/:id | Elimina un prodotto | Required |
| GET | /api/services | Recupera elenco di tutti i servizi | Required |
| POST | /api/validate | Esegui validazione dello schema | Required |
| GET | /api/visibility-addon/status | Stato e punteggio di visibilità IA | Required |
| GET | /api/visibility-addon/keywords | Elencare le parole chiave tracciate | Required |
| POST | /api/stores/:storeId/scan | Avviare la scansione del sito web | Required |
| GET | /api/stores/:storeId/scan-results | Ottenere i risultati della scansione | Required |
| GET | /api/visibility-addon/citations | Elencare le citazioni IA | Required |
| GET | /api/visibility-addon/competitors | Ottenere concorrenti e classifiche | Required |
| GET | /api/gsc/analytics | Dati di Google Search Console | Required |
| GET | /api/content/recommendations | Ottenere raccomandazioni sui contenuti | Required |
| GET | /api/sentiment/overview | Panoramica dell'analisi del sentiment | Required |
Le informazioni sui limiti di richieste vengono restituite negli header di risposta: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.
Testa tutti gli endpoint direttamente nell'interfaccia Swagger interattiva. Oltre 50 endpoint con schemi, esempi e funzione prova.
Apri 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'}
)Il nostro supporto sviluppatori ti aiuterà con l'integrazione.
Contatta il supporto