EN
FR
ES
DE
IT
KO
Vuoi automatizzare i tuoi audit di visibilità IA, integrare i risultati nel tuo dashboard interno o connettere AILabsAudit ai tuoi strumenti esistenti? L'API REST v1 è pensata per questo. Questa guida pratica ti accompagna dalla prima richiesta ai pattern di integrazione avanzati.
Perché integrare l'API REST di AILabsAudit?
L'interfaccia web di AILabsAudit è ideale per un uso manuale, ma ha i suoi limiti quando gestisci decine di clienti o devi automatizzare i workflow. L'API REST apre possibilità che l'interfaccia non può offrire:
- Automazione completa: Lancia audit programmati tramite cron job o workflow CI/CD
- Integrazione dashboard: Visualizza i punteggi di visibilità IA direttamente nel tuo strumento di reporting
- Avvisi personalizzati: Rileva i cali di visibilità e notifica automaticamente i tuoi team
- Report su misura: Combina i dati AILabsAudit con le tue metriche per report arricchiti
- Sincronizzazione CRM: Collega i dati di audit alle schede clienti nel tuo CRM
Cosa puoi fare con l'API
Gestione clienti
Accedi all'intero portafoglio clienti tramite l'endpoint /api/v1/clients. Recupera dettagli, contatti, concorrenti e la vista 360° completa di ogni cliente.
Audit e risultati
Lancia nuovi audit programmaticamente con POST /api/v1/audits/launch, monitora il loro avanzamento e recupera i risultati dettagliati: punteggi di visibilità, performance per modello IA, trend e confronti.
Report PDF
Scarica i report PDF premium tramite GET /api/v1/reports/{id}/download per integrarli nei tuoi workflow di consegna clienti automatizzati.
Analytics e portfolio
Accedi alle analytics avanzate: panoramica del portfolio, classifica di visibilità, distribuzione dei punteggi. Perfetto per costruire dashboard di monitoraggio multi-cliente.
Quick start in 3 passaggi
Passaggio 1: Creare la tua chiave API
Vai in Account → API & Integrations e crea una nuova chiave. Inizierà con aila_.
Passaggio 2: Testare la connessione
Prima richiesta
curl -H "X-Api-Key: aila_tua_chiave" https://ailabsaudit.com/api/v1/clientsSe vedi l'elenco dei tuoi clienti in JSON, tutto funziona!
Passaggio 3: Esplorare gli endpoint
Consulta il tutorial API REST completo per scoprire gli 8 gruppi di endpoint, oppure esplora direttamente la documentazione Swagger.
Pattern di integrazione comuni
Audit pianificati automatici
Il caso d'uso più popolare: un cron job che lancia un audit per ogni cliente a intervalli regolari (settimanale o mensile), recupera i risultati e li memorizza nel tuo database.
# Esempio: audit mensile per tutti i clienti
import requests
API_KEY = "aila_tua_chiave"
BASE = "https://ailabsaudit.com/api/v1"
headers = {"X-Api-Key": API_KEY}
clients = requests.get(f"{BASE}/clients", headers=headers).json()
for client in clients["data"]:
requests.post(f"{BASE}/audits/launch",
headers=headers,
json={"client_id": client["id"]})
Dashboard embedding
Integra i punteggi di visibilità nel tuo dashboard chiamando l'endpoint analytics:
scores = requests.get(f"{BASE}/analytics/leaderboard", headers=headers).json()
# Visualizza nella tua interfacciaAvvisi di calo di visibilità
Confronta i punteggi tra due audit successivi e invia un avviso (email, Slack) se un cliente perde più di 10 punti:
audit_history = requests.get(
f"{BASE}/audits?client_id=42&per_page=2",
headers=headers
).json()
# Confronta i punteggi e avvisa se necessarioBest practice
Rispetta il rate limiting
L'API consente 60 richieste al minuto per chiave. Distanzia le tue chiamate e implementa un backoff esponenziale per gli errori 429. Consulta gli header X-RateLimit-* per monitorare il tuo consumo.
Memorizza in cache le risposte
I dati di audit non cambiano frequentemente. Metti in cache le risposte (Redis, file locale) per 1-24h per ridurre le chiamate API e migliorare le performance della tua applicazione.
Gestisci gli errori correttamente
L'API restituisce codici HTTP standard e messaggi di errore in JSON. Gestisci almeno i casi 401 (chiave non valida), 429 (rate limit) e 500 (errore server).
Proteggi la tua chiave
Memorizza la tua chiave API in una variabile d'ambiente, mai nel codice sorgente. Usa chiavi diverse per ambiente (dev/produzione) e revoca immediatamente una chiave compromessa.
Risorse utili
Per approfondire
Esplora queste risorse per padroneggiare l'API REST:
- Tutorial API REST completo — Guida passo-passo con esempi di codice
- Documentazione Swagger — Riferimento interattivo di tutti gli endpoint
- Glossario: API REST — Definizione e concetti chiave
- Guida MCP — Connetti la tua IA direttamente ad AILabsAudit
FAQ
Quale abbonamento serve per accedere all'API REST?
L'API REST è disponibile con i piani Agent e Agence+. I piani gratuiti e standard non includono l'accesso API. Richiedi un accesso partner per iniziare.
L'API REST usa le stesse chiavi del MCP?
Sì, è la stessa chiave API (formato aila_...). Puoi usarla sia per le chiamate REST che per le connessioni MCP. Creala da API & Integrations.
Qual è il limite di richieste?
60 richieste al minuto per chiave API. Gli header di risposta (X-RateLimit-Remaining) ti indicano il tuo consumo in tempo reale.
Posso lanciare audit tramite l'API?
Sì, l'endpoint POST /api/v1/audits/launch permette di lanciare audit programmaticamente. Puoi stimare il costo in crediti in anticipo e monitorare l'avanzamento dell'audit.
Esiste un SDK ufficiale?
Non ancora, ma il tutorial API REST fornisce esempi completi in Python, JavaScript e PHP che puoi usare come base. Un SDK ufficiale è in fase di sviluppo.
Conclusione
L'API REST di AILabsAudit è la chiave per passare dall'uso manuale all'automazione completa dei tuoi audit di visibilità IA. Che tu voglia pianificare audit ricorrenti, integrare i punteggi nel tuo dashboard o creare avvisi personalizzati, l'API ti fornisce gli strumenti per farlo.
Pronto ad automatizzare?
Articolo revisionato e aggiornato: maggio 2026 — verificato rispetto ai comportamenti attuali di ChatGPT, Claude, Gemini e Perplexity.
Ogni domanda posta a ChatGPT senza il tuo nome nella risposta è un competitor raccomandato al posto tuo — misurato su 6.820 risposte AI reali.