Autenticazione
Ogni richiesta deve includere un token API creato in Dashboard, sezione Integrations and API.
Authorization: Bearer aem_il_tuo_token
Usa l'header Authorization per ogni integrazione. Le API key nella query string sono deprecate: possono essere conservate nella cronologia e nei log degli URL. Il supporto precedente resta disponibile per consentire la migrazione dei client.
Status account
Verifica token, piano, limiti e uso corrente.
{
"success": true,
"user": {"id": 42, "email": "tu@esempio.com", "plan": "agency"},
"usage": {"analyses": 12, "geo_queries": 5},
"limits": {"analyses": 100, "geo_queries": 50},
"api_version": "1.0"
}
Brands
Lista brand e dettaglio singolo brand.
{
"success": true,
"brands": [
{"id": 1, "name": "Acme SRL", "domain": "acme.it", "last_geo_score": 67}
],
"total": 1
}
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
id | integer | required | ID del brand |
AEO score
Ultimo score AEO per URL e storico analisi.
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
url | string | required | URL completo |
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
url | string | required | URL target |
limit | integer | optional | Default 20, max 100 |
GEO score
Ultimo GEO score e storico per brand.
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
brand_id | integer | required | ID del brand |
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
brand_id | integer | required | ID del brand |
limit | integer | optional | Default 20, max 100 |
Errori API
Le risposte di errore includono sempre success:false, error e code.
| HTTP | Code | Causa |
|---|---|---|
| 401 | UNAUTHORIZED | Token mancante o non valido |
| 403 | PLAN_REQUIRED | Piano insufficiente |
| 400 | MISSING_PARAM | Parametro obbligatorio assente |
| 400 | INVALID_ACTION | Azione non supportata |
| 404 | NOT_FOUND | Brand o analisi non trovati |
| 429 | RATE_LIMIT | Troppe richieste |
| 500 | SERVER_ERROR | Errore interno server |
{
"success": false,
"error": "Descrizione errore",
"code": "CODICE_ERRORE"
}
Esempi rapidi
Snippet pronti per test veloci.
curl -H "Authorization: Bearer aem_il_tuo_token" "https://aeometrix.it/api.php?action=status" curl -H "Authorization: Bearer aem_il_tuo_token" "https://aeometrix.it/api.php?action=brands" curl -H "Authorization: Bearer aem_il_tuo_token" "https://aeometrix.it/api.php?action=aeo_score&url=https://esempio.com" curl -H "Authorization: Bearer aem_il_tuo_token" "https://aeometrix.it/api.php?action=geo_score&brand_id=1"
const API = 'https://aeometrix.it/api.php';
const TOKEN = 'aem_il_tuo_token';
const call = (action, params = {}) =>
fetch(`${API}?` + new URLSearchParams({ action, ...params }), {
headers: { Authorization: `Bearer ${TOKEN}` }
}).then(r => r.json());
Consumi AI registrati
Sessione verificata o Bearer. Il mese รจ UTC e facoltativo; vengono restituiti soltanto i consumi dell'account autenticato. Risposta privata non memorizzabile in cache.
Copertura: trasporti cloud GEO condivisi e commenti semantici. coverage_complete=false: gli altri moduli non sono inclusi. I costi sono stime da tariffe configurate, non fatture.
total_tokens e estimated_usd rimangono null se il gruppo contiene dati mancanti. Le somme dei soli valori noti sono separate in reported_total_tokens e known_estimated_usd, con il numero di tentativi incompleti o non prezzati.