API Reference - AEO Metrix

Autenticazione

Ogni richiesta deve includere un token API creato in Dashboard, sezione Integrations and API.

Header consigliato

Authorization: Bearer aem_il_tuo_token

Query string (solo test)

https://aeometrix.it/api.php?action=status&api_key=aem_il_tuo_token

Status account

Verifica token, piano, limiti e uso corrente.

GET https://aeometrix.it/api.php?action=status health endpoint

Esempio risposta

{
  "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.

GET https://aeometrix.it/api.php?action=brands lista brand

{
  "success": true,
  "brands": [
    {"id": 1, "name": "Acme SRL", "domain": "acme.it", "last_geo_score": 67}
  ],
  "total": 1
}

GET https://aeometrix.it/api.php?action=brand&id={brand_id} dettaglio brand

Parametri

Nome	Tipo	Obbligatorio	Descrizione
`id`	`integer`	required	ID del brand

AEO score

Ultimo score AEO per URL e storico analisi.

GET https://aeometrix.it/api.php?action=aeo_score&url={url} ultimo AEO

Parametri

Nome	Tipo	Obbligatorio	Descrizione
`url`	`string`	required	URL completo

GET https://aeometrix.it/api.php?action=aeo_history&url={url}&limit={n} storico AEO

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.

GET https://aeometrix.it/api.php?action=geo_score&brand_id={id} ultimo GEO

Nome	Tipo	Obbligatorio	Descrizione
`brand_id`	`integer`	required	ID del brand

GET https://aeometrix.it/api.php?action=geo_history&brand_id={id}&limit={n} storico GEO

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

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"

JavaScript fetch

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());

REST API per AEO e GEO data integration