G Tech Group

GTG SEO API: guida per sviluppatori

Un'API REST per leggere e gestire dal tuo codice quello che vedi nell'applicazione: progetti e posizioni, scansioni dello Spider, GEO Audit, AI Visibility, siti e analisi, dati di Search Console e Analytics.

Introduzione

L'API è pensata per automazioni (script, cruscotti, strumenti interni) e per le app collegate al servizio. Tutto ciò che fa l'API riguarda i dati del tuo account: non puoi leggere né modificare quelli di altri utenti, e una risorsa altrui risponde come se non esistesse (404).

Indirizzo di base: https://seo.gtechgroup.it/api/v1

Versioni e percorsi

La versione corrente è v1 e il percorso canonico è /api/v1/.... Per compatibilità le stesse risorse rispondono anche su /api/seo/... e /api/v1/seo/... (usati dall'app Android) e, per siti, analisi e storico, sui percorsi del vecchio sito: /api/websites, /api/audits, /api/archived-audits. Tutti i percorsi in questa pagina sono relativi a /api/v1.

Autenticazione

Ogni chiamata (tranne login, spiegazioni e controllo di salute) richiede una chiave API nell'intestazione Authorization: Authorization: Bearer <chiave>.

Come ottenere una chiave

La chiave è equivalente alla tua password per l'API: non inserirla in repository o pagine pubbliche. Le chiavi sono salvate solo come hash; se la perdi non è recuperabile, se ne emette una nuova. Se l'account è disattivato o il piano non include l'accesso API la risposta è 401.

Nota tecnica: la chiave è un token Sanctum; le chiavi del vecchio sito sono state importate e continuano a funzionare.

Primi passi

Tre chiamate per vedere che tutto funziona. Sostituisci $API_KEY con la tua chiave.

1. Verifica la chiave

curl -H "Authorization: Bearer $API_KEY" https://seo.gtechgroup.it/api/v1/auth/me
{
    "data": {
        "id": 1,
        "name": "Gianluca",
        "email": "nome@esempio.it"
    }
}

2. Crea un progetto nel rank tracker

curl -X POST https://seo.gtechgroup.it/api/v1/projects \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"lum.it","domain":"lum.it"}'
{
    "data": {
        "id": 11
    }
}

3. Aggiungi keyword e leggi il progetto

curl -X POST https://seo.gtechgroup.it/api/v1/projects/11/keywords \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"keywords":["illuminazione led","faretti da incasso"]}'

curl -H "Authorization: Bearer $API_KEY" https://seo.gtechgroup.it/api/v1/projects/11
{
    "data": {
        "added": 2,
        "skipped": 0,
        "removed": 0
    }
}

Risposte ed errori

Le risposte di successo hanno sempre la forma {"data": ..., "meta": {...}}; meta compare nelle liste paginate e contiene page, per_page, total_results e total_pages. Gli errori hanno la forma {"errors": [{"title": "...", "status": "422"}]} e a volte un campo code leggibile dalle macchine (per esempio quota, twofa_required).

Codici di stato

200OK.
201Creato (o messo in coda: vedi "Operazioni lunghe").
401Chiave mancante o non valida, account non attivo, piano senza API.
403Operazione non consentita dal piano (limite raggiunto, strumento a pagamento).
404La risorsa non esiste o non è tua.
409Integrazione non collegata (per esempio Google o DataForSEO).
422Dati non validi.
429Troppe richieste: aspetta e riprova.
501Funzione non disponibile su questa installazione.
503Servizio esterno non configurato.

Liste, paginazione, filtri e ordinamento

Le liste del rank tracker, dello Spider e delle risorse GEO/AI usano page e per_page (massimo 100, predefinito 25). Con format=csv ottieni un file CSV (fino a 5000 righe) al posto del JSON.

Siti, analisi e storico (/websites, /audits, /archived-audits) usano la forma del vecchio sito: page, results_per_page (10, 25, 50, 100, 250, 500 o 1000), search con search_by, order_by con order_type (ASC/DESC), i filtri per id (website_id, domain_id, audit_id) e l'intervallo di date con datetime_field, datetime_start e datetime_end. La risposta contiene anche links (first, last, next, prev, self) oltre a meta. Un valore di ordinamento non previsto viene ignorato, senza errore.

Operazioni lunghe e coda

Le operazioni che richiedono tempo (nuova analisi, scansione Spider, GEO Audit, misurazioni AI, aggiornamento delle posizioni) non aspettano il risultato: su /api/v1 rispondono subito 202 Accepted con l'intestazione Location (URL della risorsa da leggere) e status: "queued"; il lavoro prosegue in coda. Per sapere quando è finito leggi la risorsa con una GET finché lo stato non cambia. I percorsi legacy dell'app Android (/api/seo, /api/v1/seo, percorsi nudi) mantengono i codici storici 200/201.

Per non creare doppioni quando ripeti una chiamata (timeout, rete instabile) invia Idempotency-Key: <valore unico>: entro 24 ore la stessa chiave con lo stesso corpo restituisce la risposta originale (Idempotent-Replayed: true) senza accodare di nuovo il lavoro; con un corpo diverso risponde 422 idempotency_mismatch. Gli strumenti a pagamento (ricerca keyword, misurazioni e ricerche AI) consumano crediti o budget AI e rispettano i tetti di spesa; l'API non ha un passaggio di conferma come l'applicazione, quindi usali con consapevolezza.

Limiti

Le chiamate autenticate sono limitate a 60 al minuto per utente (429 oltre il limite, con Retry-After). Le operazioni costose (nuova scansione, audit, analisi AI, refresh, ricerca keyword, esportazioni CSV) hanno un limite più stretto a parte (10 al minuto e 300 al giorno per utente). Ogni risposta riporta X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Il login è limitato a 20 richieste al minuto per indirizzo IP e blocca per 15 minuti dopo 5 tentativi falliti sullo stesso account; le chiavi sbagliate sono limitate per IP. I limiti del tuo piano (progetti, keyword, scansioni, analisi) valgono anche via API e rispondono 403 con code.

L'API risponde con CORS abilitato (Access-Control-Allow-Origin: *): la sicurezza è nella chiave Bearer, non nei cookie.

Le GET restituiscono `ETag`: rimandalo in `If-None-Match` e, se nulla è cambiato, ricevi `304 Not Modified` senza corpo. Gli elenchi statici (località, lingue) e la specifica OpenAPI si possono tenere in cache per un'ora.

Le chiavi possono avere ambiti: `read` (solo GET), `write` (anche scritture) e `admin` (anche rotazione della chiave). Le chiavi già emesse hanno accesso completo. Senza l'ambito necessario rispondi 403 `insufficient_scope`.

Ogni errore riporta `title`, `status` (stringa) e un `code` stabile, più `id` (lo stesso di `X-Request-Id`: citalo se scrivi al supporto). Il piano senza accesso API risponde 403 `plan_no_api` su `/api/v1` (401 sui percorsi legacy).

missing_keyManca l'intestazione Authorization: Bearer.
invalid_keyChiave API sconosciuta, scaduta o revocata.
inactive_accountAccount non attivo.
plan_no_apiIl piano non include l'API (403 su /api/v1, 401 sui percorsi legacy).
insufficient_scopeLa chiave non ha l'ambito richiesto (read, write, admin).
quota_exceededCredito o quota esaurita (es. 402 DataForSEO).
validation_failedDati non validi (422): vedi `fields`.
throttledTroppe richieste (429): vedi `Retry-After`.
not_foundRisorsa inesistente o non tua.
not_implementedAzione non disponibile (501).
idempotency_mismatchIdempotency-Key gia' usata con un corpo diverso (422).
idempotency_in_progressUna richiesta con la stessa Idempotency-Key e' ancora in corso (409).
idempotency_key_invalidIdempotency-Key non valida (422).
payload_too_largeCorpo troppo grande (413).
twofa_requiredServe il codice a due fattori (login).
twofa_invalidCodice a due fattori non valido (login).

Webhook

Non ci sono webhook: per sapere se un lavoro è finito si legge la risorsa (vedi sopra). Gli avvisi (cali di posizione, regressioni) sono leggibili con GET /alerts.

Spiegazioni di punteggi e metriche

Per ogni punteggio e metrica esiste un testo in linguaggio semplice che spiega cosa misura, perché conta e come migliorarlo. È contenuto statico e pubblico: GET /explain elenca le voci e GET /explain/{key}?lang=it|en restituisce il dettaglio. Puoi usarlo per mostrare un aiuto accanto ai numeri nelle tue interfacce.

keyDescrizione
geo_scorePunteggio GEO
avg_page_scoreMedia del punteggio delle pagine (GEO)
site_penaltiesPenalità di sito (GEO)
ai_crawlersAccesso dei crawler AI
llms_txtFile llms.txt
entity_schemaEntità del sito (schema Organization)
geo_scoring_versionVersione del calcolo GEO
g_scoreG Score
audit_scorePunteggio dell'Audit
spider_scorePunteggio di una pagina (Spider)
issue_severityGravità dei problemi
visibility_scorePunteggio AI Visibility
share_of_voiceQuota di presenza (Share of Voice)
citation_positionPosizione di citazione
position_bucketsFasce di posizione
gained_lostKeyword guadagnate e perse
avg_positionPosizione media
search_volumeVolume di ricerca
impressionsImpressioni
clicksClic
ctrCTR (percentuale di clic)
ttfbTempo di prima risposta (TTFB)
link_graphGrafo dei link

Riferimento delle operazioni

Auth

Accesso e credenziali

post /auth/login Login: restituisce la chiave API Pubblico · 200

Accetta email e password dell'account e restituisce una chiave API personale da usare come Authorization: Bearer <chiave>. Se l'account ha la 2FA attiva serve anche twofa_token (altrimenti 401 con code: twofa_required). Dopo 5 tentativi falliti per email+IP il login resta bloccato 15 minuti (429). Alias compatibile con l'app Android: POST /api/login.

Parametri

NomeDoveTipoDescrizione
email obbligatorio corpo string Email dell'account.
password obbligatorio corpo string Password.
twofa_token facoltativo corpo string Codice a 6 cifre della 2FA, se attiva.
device_name facoltativo corpo string Nome del dispositivo (etichetta della chiave).

Corpo della richiesta (JSON)

{
    "email": "nome@esempio.it",
    "password": "********",
    "device_name": "script-locale"
}

Esempio di risposta

{
    "data": {
        "api_key": "1|AbCdEf0123456789...",
        "user": {
            "id": 1,
            "name": "Gianluca",
            "email": "nome@esempio.it"
        }
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/auth/login' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "nome@esempio.it",
    "password": "********",
    "device_name": "script-locale"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/auth/login');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['email' => 'nome@esempio.it', 'password' => '********', 'device_name' => 'script-locale']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "email": "nome@esempio.it",
    "password": "********",
    "device_name": "script-locale"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/auth/login', json={'email': 'nome@esempio.it', 'password': '********', 'device_name': 'script-locale'})
data = r.json()['data']
delete /auth/token Logout: revoca la chiave in uso Chiave API · 200

Revoca la credenziale con cui stai chiamando. Dopo questa chiamata la chiave non funziona più.

Esempio di risposta

{
    "data": {
        "revoked": true
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/auth/token' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/auth/token');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/auth/token', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/auth/token', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /auth/me Utente corrente Chiave API · 200

Restituisce id, nome ed email dell'utente a cui appartiene la chiave. Utile per verificare che la chiave sia valida.

Esempio di risposta

{
    "data": {
        "id": 1,
        "name": "Gianluca",
        "email": "nome@esempio.it"
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/auth/me' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/auth/me');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/auth/me', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/auth/me', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']

Meta

Scoperta, stato e cataloghi

get / Scoperta dell'API Chiave API · 200

Elenca versione, base URL e risorse disponibili, e riassume le regole generali (paginazione, CSV, rate limit).

Esempio di risposta

{
    "data": {
        "name": "SEO API",
        "version": "v1",
        "base_url": "https://seo.gtechgroup.it/api/v1",
        "auth": "Authorization: Bearer <api_key>",
        "docs": "https://seo.gtechgroup.it/api/docs",
        "resources": [
            "status",
            "projects",
            "keywords",
            "spider"
        ]
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /status Stato delle integrazioni Chiave API · 200

Dice quali integrazioni sono configurate (DataForSEO, Google), se l'utente ha collegato Google e quali tabelle/moduli risultano disponibili. L'app Android lo usa per decidere cosa mostrare.

Esempio di risposta

{
    "data": {
        "dataforseo_configured": false,
        "google_configured": true,
        "google_connected": true,
        "google_email": "nome@gmail.com",
        "api_enabled": true,
        "user_id": 1,
        "tables": {
            "projects": true,
            "keywords": true,
            "spider_scans": true
        }
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/status' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/status');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/status', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/status', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /locations Catalogo location (paesi/città) Chiave API · 200

Elenco dei codici location usati dal rank tracker (es. 2380 = Italia). Richiede DataForSEO configurato, altrimenti 409.

Parametri

NomeDoveTipoDescrizione
q facoltativo query string Testo da cercare nel nome. · Italia
country facoltativo query string Codice paese ISO a 2 lettere. · IT
limit facoltativo query integer Massimo di righe (1-500, predefinito 100). · 20

Esempio di risposta

{
    "data": [
        {
            "location_code": 2380,
            "location_name": "Italy",
            "country_iso_code": "IT"
        }
    ]
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/locations' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/locations');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/locations', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/locations', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /languages Catalogo lingue Chiave API · 200

Elenco dei codici lingua accettati per i progetti del rank tracker.

Parametri

NomeDoveTipoDescrizione
q facoltativo query string Testo da cercare. · ita

Esempio di risposta

{
    "data": [
        {
            "code": "it",
            "name": "Italiano"
        },
        {
            "code": "en",
            "name": "English"
        }
    ]
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/languages' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/languages');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/languages', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/languages', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']

Rank tracker

Progetti, keyword e posizioni

get /projects Elenco dei progetti Chiave API · 200

I tuoi progetti del rank tracker, dal più recente. Supporta paginazione e esportazione CSV.

Parametri

NomeDoveTipoDescrizione
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "id": 11,
            "name": "lum.it",
            "domain": "lum.it",
            "location_code": 2380,
            "language_code": "it",
            "keywords": 38,
            "gsc_property": null,
            "ga4_property": null,
            "last_datetime": "2026-11-12 06:10:00",
            "datetime": "2026-07-18 10:02:11"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/projects' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/projects');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/projects', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/projects', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /projects Crea un progetto Chiave API · 201

Crea un progetto per un dominio. Il dominio viene normalizzato (senza schema e senza www). Rispetta la quota progetti del tuo piano: oltre il limite risponde 403 con code: quota.

Parametri

NomeDoveTipoDescrizione
name obbligatorio corpo string Nome del progetto.
domain obbligatorio corpo string Dominio da monitorare.
location_code facoltativo corpo integer Codice location (predefinito 2380, Italia).
language_code facoltativo corpo string Codice lingua (predefinito it).

Corpo della richiesta (JSON)

{
    "name": "lum.it",
    "domain": "https://www.lum.it/",
    "location_code": 2380,
    "language_code": "it"
}

Esempio di risposta

{
    "data": {
        "id": 11
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/projects' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "lum.it",
    "domain": "https://www.lum.it/",
    "location_code": 2380,
    "language_code": "it"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/projects');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['name' => 'lum.it', 'domain' => 'https://www.lum.it/', 'location_code' => 2380, 'language_code' => 'it']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/projects', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "lum.it",
    "domain": "https://www.lum.it/",
    "location_code": 2380,
    "language_code": "it"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/projects', headers={'Authorization': f'Bearer {API_KEY}'}, json={'name': 'lum.it', 'domain': 'https://www.lum.it/', 'location_code': 2380, 'language_code': 'it'})
data = r.json()['data']
get /projects/{id} Dettaglio progetto con statistiche Chiave API · 200

Il progetto con le sue keyword e le statistiche: keyword monitorate, quante hanno una posizione, posizione media, distribuzione per fascia (buckets, intervalli esclusivi: top10 = posizioni 4-10), le keyword guadagnate/perse tra le ultime due rilevazioni (gained/lost, massimo 5, delta = precedente - attuale, positivo = migliorata) e l'andamento giornaliero (timeline).

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del progetto. · 11
format facoltativo query string Con csv esporta le keyword del progetto. · csv

Esempio di risposta

{
    "data": {
        "id": 11,
        "name": "lum.it",
        "domain": "lum.it",
        "location_code": 2380,
        "language_code": "it",
        "keywords": 38,
        "gsc_property": null,
        "ga4_property": null,
        "last_datetime": "2026-11-12 06:10:00",
        "datetime": "2026-07-18 10:02:11",
        "stats": {
            "tracked": 38,
            "ranking": 31,
            "avg_position": 14.2,
            "buckets": {
                "top3": 4,
                "top10": 9,
                "top20": 8,
                "top50": 7,
                "top100": 3,
                "none": 7
            },
            "gained": [
                {
                    "keyword": "led da incasso",
                    "delta": 5,
                    "from": 12,
                    "to": 7
                }
            ],
            "lost": [],
            "timeline": {
                "2026-11-11": 14.5,
                "2026-11-12": 14.2
            }
        }
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/projects/11' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/projects/11');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/projects/11', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/projects/11', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
patch /projects/{id} Aggiorna un progetto Chiave API · 200

Modifica i campi indicati: nome, dominio, location, lingua e le proprietà Google collegate (gsc_property, ga4_property).

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del progetto. · 11
name facoltativo corpo string Nuovo nome.
domain facoltativo corpo string Nuovo dominio.
location_code facoltativo corpo integer Codice location.
language_code facoltativo corpo string Codice lingua.
gsc_property facoltativo corpo string Proprietà Search Console.
ga4_property facoltativo corpo string Id proprietà GA4 (solo cifre).

Corpo della richiesta (JSON)

{
    "name": "LUM illuminazione"
}

Esempio di risposta

{
    "data": {
        "id": 11
    }
}

Esempi di codice

curl -X PATCH 'https://seo.gtechgroup.it/api/v1/projects/11' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "LUM illuminazione"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/projects/11');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['name' => 'LUM illuminazione']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/projects/11', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "LUM illuminazione"
}),
});
const { data } = await res.json();
import requests

r = requests.patch('https://seo.gtechgroup.it/api/v1/projects/11', headers={'Authorization': f'Bearer {API_KEY}'}, json={'name': 'LUM illuminazione'})
data = r.json()['data']
delete /projects/{id} Elimina un progetto Chiave API · 200

Elimina il progetto con tutte le sue keyword e lo storico delle posizioni. Non si può annullare.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del progetto. · 11

Esempio di risposta

{
    "data": {
        "id": 11
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/projects/11' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/projects/11');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/projects/11', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/projects/11', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /projects/{id}/keywords Aggiunge keyword al progetto Chiave API · 201

Aggiunge una o più keyword (fino a 1000 per richiesta). I duplicati vengono saltati. Con mode: replace sostituisce tutte le keyword del progetto (e il loro storico). Rispetta la quota keyword del piano.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del progetto. · 11
keywords facoltativo corpo array Elenco di keyword (alternativa a keyword).
keyword facoltativo corpo string Una sola keyword.
mode facoltativo corpo string add (predefinito) o replace.

Corpo della richiesta (JSON)

{
    "keywords": [
        "illuminazione led",
        "faretti da incasso"
    ],
    "mode": "add"
}

Esempio di risposta

{
    "data": {
        "added": 2,
        "skipped": 0,
        "removed": 0
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/projects/11/keywords' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "keywords": [
        "illuminazione led",
        "faretti da incasso"
    ],
    "mode": "add"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/projects/11/keywords');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['keywords' => ['illuminazione led', 'faretti da incasso'], 'mode' => 'add']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/projects/11/keywords', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "keywords": [
        "illuminazione led",
        "faretti da incasso"
    ],
    "mode": "add"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/projects/11/keywords', headers={'Authorization': f'Bearer {API_KEY}'}, json={'keywords': ['illuminazione led', 'faretti da incasso'], 'mode': 'add'})
data = r.json()['data']
post /projects/{id}/refresh Rileva di nuovo le posizioni Chiave API · 202

Mette in coda il controllo delle posizioni del progetto. Può usare crediti DataForSEO: usalo con consapevolezza. Risponde subito; i risultati compaiono nelle letture successive.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del progetto. · 11
Idempotency-Key facoltativo platform::docs.ref_in_header string Opzionale. Stringa unica (1-255 caratteri ASCII) scelta da te: ripetendo la richiesta entro 24 ore con la stessa chiave e lo stesso corpo ricevi la risposta originale (Idempotent-Replayed: true) senza duplicare il lavoro; stessa chiave con corpo diverso = 422 idempotency_mismatch.

Esempio di risposta

{
    "data": {
        "queued": true,
        "project_id": 11
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/projects/11/refresh' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/projects/11/refresh');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/projects/11/refresh', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/projects/11/refresh', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /keywords Tutte le keyword Chiave API · 200

Le keyword di tutti i tuoi progetti, con ultima posizione e URL che si posiziona.

Parametri

NomeDoveTipoDescrizione
project_id facoltativo query integer Solo le keyword di questo progetto. · 11
tag facoltativo query string Solo le keyword con questa etichetta. · prodotti
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "id": 301,
            "project_id": 11,
            "keyword": "illuminazione led",
            "search_volume": 1900,
            "last_position": 7,
            "last_url": "https://lum.it/led/",
            "target_url": null,
            "tags": [
                "prodotti"
            ],
            "notes": null,
            "last_datetime": "2026-11-12 06:10:00",
            "datetime": "2026-07-18 10:03:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/keywords' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/keywords');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/keywords', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/keywords', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
delete /keywords Elimina più keyword Chiave API · 200

Elimina in blocco le keyword con gli id indicati (solo le tue).

Parametri

NomeDoveTipoDescrizione
ids obbligatorio corpo array Id delle keyword da eliminare.

Corpo della richiesta (JSON)

{
    "ids": [
        301,
        302
    ]
}

Esempio di risposta

{
    "data": {
        "deleted": 2
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/keywords' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": [
        301,
        302
    ]
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/keywords');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['ids' => [301, 302]]),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/keywords', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "ids": [
        301,
        302
    ]
}),
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/keywords', headers={'Authorization': f'Bearer {API_KEY}'}, json={'ids': [301, 302]})
data = r.json()['data']
get /keywords/{id} Dettaglio keyword Chiave API · 200

Una keyword con posizione, URL, volume, etichette e note.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della keyword. · 301

Esempio di risposta

{
    "data": {
        "id": 301,
        "project_id": 11,
        "keyword": "illuminazione led",
        "search_volume": 1900,
        "last_position": 7,
        "last_url": "https://lum.it/led/",
        "target_url": null,
        "tags": [
            "prodotti"
        ],
        "notes": null,
        "last_datetime": "2026-11-12 06:10:00",
        "datetime": "2026-07-18 10:03:00"
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/keywords/301' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/keywords/301');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/keywords/301', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/keywords/301', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
patch /keywords/{id} Aggiorna una keyword Chiave API · 200

Imposta l'URL obiettivo, le etichette e le note della keyword.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della keyword. · 301
target_url facoltativo corpo string URL che vorresti posizionare.
tags facoltativo corpo string Etichette.
notes facoltativo corpo string Note libere.

Corpo della richiesta (JSON)

{
    "target_url": "https://lum.it/led/",
    "tags": [
        "prodotti"
    ]
}

Esempio di risposta

{
    "data": {
        "id": 301
    }
}

Esempi di codice

curl -X PATCH 'https://seo.gtechgroup.it/api/v1/keywords/301' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "target_url": "https://lum.it/led/",
    "tags": [
        "prodotti"
    ]
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/keywords/301');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['target_url' => 'https://lum.it/led/', 'tags' => ['prodotti']]),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/keywords/301', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "target_url": "https://lum.it/led/",
    "tags": [
        "prodotti"
    ]
}),
});
const { data } = await res.json();
import requests

r = requests.patch('https://seo.gtechgroup.it/api/v1/keywords/301', headers={'Authorization': f'Bearer {API_KEY}'}, json={'target_url': 'https://lum.it/led/', 'tags': ['prodotti']})
data = r.json()['data']
delete /keywords/{id} Elimina una keyword Chiave API · 200

Elimina la keyword e il suo storico.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della keyword. · 301

Esempio di risposta

{
    "data": {
        "id": 301
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/keywords/301' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/keywords/301');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/keywords/301', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/keywords/301', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /keywords/{id}/history Storico delle posizioni Chiave API · 200

Le posizioni rilevate nel tempo per la keyword (per i grafici). position è null quando il sito non compare nei primi 100.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della keyword. · 301
days facoltativo query integer Giorni di storico (massimo 365). · 90

Esempio di risposta

{
    "data": {
        "keyword": "illuminazione led",
        "history": [
            {
                "position": 9,
                "url": "https://lum.it/led/",
                "datetime": "2026-11-11 06:10:00"
            },
            {
                "position": 7,
                "url": "https://lum.it/led/",
                "datetime": "2026-11-12 06:10:00"
            }
        ]
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/keywords/301/history' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/keywords/301/history');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/keywords/301/history', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/keywords/301/history', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']

Spider

Scansioni del sito (crawler interno)

get /spider Elenco delle scansioni Chiave API · 200

Le tue scansioni dello Spider (il crawler che analizza tutte le pagine del sito), dalla più recente.

Parametri

NomeDoveTipoDescrizione
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "id": 94,
            "name": "lum.it",
            "host": "lum.it",
            "status": "completed",
            "score": 82,
            "pages_found": 214,
            "pages_processed": 214,
            "errors_count": 6,
            "warnings_count": 31,
            "started_datetime": "2026-11-10 03:00:02",
            "finished_datetime": "2026-11-10 03:14:40",
            "datetime": "2026-11-10 03:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/spider' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/spider', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /spider Avvia una nuova scansione Chiave API · 202

Mette in coda una scansione del sito partendo dall'URL indicato. Risponde 201 subito: leggi poi GET /spider/{id} finché status non è completed. Rispetta i limiti del piano (pagine, scansioni attive) e blocca gli indirizzi interni.

Parametri

NomeDoveTipoDescrizione
Idempotency-Key facoltativo platform::docs.ref_in_header string Opzionale. Stringa unica (1-255 caratteri ASCII) scelta da te: ripetendo la richiesta entro 24 ore con la stessa chiave e lo stesso corpo ricevi la risposta originale (Idempotent-Replayed: true) senza duplicare il lavoro; stessa chiave con corpo diverso = 422 idempotency_mismatch.
start_url obbligatorio corpo string URL di partenza (anche url).
name facoltativo corpo string Nome della scansione.
max_pages facoltativo corpo integer Pagine massime (predefinito 200).
max_depth facoltativo corpo integer Profondità massima (predefinito 10).
speed facoltativo corpo string Velocità: safe (predefinito) o più alta se il piano lo consente.
include_subdomains facoltativo corpo boolean Segue anche i sottodomini.
respect_robots facoltativo corpo boolean Rispetta robots.txt.
use_sitemap facoltativo corpo boolean Usa anche la sitemap.

Corpo della richiesta (JSON)

{
    "start_url": "https://lum.it/",
    "max_pages": 200,
    "respect_robots": true
}

Esempio di risposta

{
    "data": {
        "scan_id": 94,
        "status": "pending"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/spider' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "start_url": "https://lum.it/",
    "max_pages": 200,
    "respect_robots": true
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['start_url' => 'https://lum.it/', 'max_pages' => 200, 'respect_robots' => true]),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "start_url": "https://lum.it/",
    "max_pages": 200,
    "respect_robots": true
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/spider', headers={'Authorization': f'Bearer {API_KEY}'}, json={'start_url': 'https://lum.it/', 'max_pages': 200, 'respect_robots': True})
data = r.json()['data']
get /spider/{id} Dettaglio scansione Chiave API · 200

Stato e numeri della scansione: pagine trovate ed elaborate, errori, avvisi e punteggio.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della scansione. · 94

Esempio di risposta

{
    "data": {
        "id": 94,
        "name": "lum.it",
        "host": "lum.it",
        "status": "completed",
        "score": 82,
        "pages_found": 214,
        "pages_processed": 214,
        "errors_count": 6,
        "warnings_count": 31,
        "started_datetime": "2026-11-10 03:00:02",
        "finished_datetime": "2026-11-10 03:14:40",
        "datetime": "2026-11-10 03:00:00"
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/spider/94' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider/94');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider/94', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/spider/94', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
patch /spider/{id} Rinomina una scansione Chiave API · 200

Cambia il nome della scansione.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della scansione. · 94
name obbligatorio corpo string Nuovo nome.

Corpo della richiesta (JSON)

{
    "name": "lum.it novembre"
}

Esempio di risposta

{
    "data": {
        "id": 94,
        "name": "lum.it novembre"
    }
}

Esempi di codice

curl -X PATCH 'https://seo.gtechgroup.it/api/v1/spider/94' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "lum.it novembre"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider/94');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['name' => 'lum.it novembre']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider/94', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "lum.it novembre"
}),
});
const { data } = await res.json();
import requests

r = requests.patch('https://seo.gtechgroup.it/api/v1/spider/94', headers={'Authorization': f'Bearer {API_KEY}'}, json={'name': 'lum.it novembre'})
data = r.json()['data']
delete /spider/{id} Elimina una scansione Chiave API · 200

Elimina la scansione, le sue pagine e i link raccolti.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della scansione. · 94

Esempio di risposta

{
    "data": {
        "id": 94
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/spider/94' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider/94');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider/94', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/spider/94', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /spider/{id}/pages Pagine scansionate Chiave API · 200

Le pagine trovate dalla scansione, con codice HTTP, tempi e problemi.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della scansione. · 94
status facoltativo query string Filtra per codice di risposta. · 404
issues facoltativo query integer Con 1 solo le pagine con problemi. · 1
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "id": 5001,
            "url": "https://lum.it/led/",
            "status_code": 200,
            "score": 88,
            "title": "Illuminazione LED",
            "h1": "Illuminazione LED",
            "is_indexable": true,
            "is_noindex": false,
            "words_count": 640,
            "images_no_alt": 1,
            "internal_links": 34,
            "external_links": 2,
            "issues": [
                "missing_meta_description"
            ]
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/spider/94/pages' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider/94/pages');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider/94/pages', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/spider/94/pages', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /spider/{id}/issues Riepilogo dei problemi Chiave API · 200

Quanti problemi ha trovato la scansione, divisi per gravità (major, moderate, minor) e per codice di problema.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della scansione. · 94

Esempio di risposta

{
    "data": {
        "by_severity": {
            "major": 2,
            "moderate": 14,
            "minor": 40
        },
        "issues": [
            {
                "code": "missing_meta_description",
                "severity": "moderate",
                "pages": 14
            }
        ]
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/spider/94/issues' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider/94/issues');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider/94/issues', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/spider/94/issues', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /spider/{id}/rescan Ripete la scansione Chiave API · 202

Mette in coda una nuova scansione con le stesse impostazioni.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della scansione. · 94
Idempotency-Key facoltativo platform::docs.ref_in_header string Opzionale. Stringa unica (1-255 caratteri ASCII) scelta da te: ripetendo la richiesta entro 24 ore con la stessa chiave e lo stesso corpo ricevi la risposta originale (Idempotent-Replayed: true) senza duplicare il lavoro; stessa chiave con corpo diverso = 422 idempotency_mismatch.

Esempio di risposta

{
    "data": {
        "scan_id": 95,
        "status": "pending"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/spider/94/rescan' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider/94/rescan');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider/94/rescan', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/spider/94/rescan', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /spider/{id}/history Storico dei controlli Chiave API · 200

I controlli registrati per la scansione (punteggio, pagine, errori e codici di risposta), dal più vecchio. Utile per i grafici di andamento.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della scansione. · 94

Esempio di risposta

{
    "data": [
        {
            "score": 82,
            "pages_found": 120,
            "pages_processed": 118,
            "errors_count": 3,
            "warnings_count": 11,
            "status_2xx": 110,
            "status_3xx": 6,
            "status_4xx": 2,
            "status_5xx": 0,
            "duration_seconds": 214,
            "started_datetime": "2026-11-12 08:00:00",
            "finished_datetime": "2026-11-12 08:03:34",
            "datetime": "2026-11-12 08:03:34"
        }
    ]
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/spider/94/history' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider/94/history');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider/94/history', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/spider/94/history', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /spider/{id}/compare Confronta due scansioni Chiave API · 200

Confronta due tue scansioni pagina per pagina: pagine aggiunte, sparite e cambiate (codice di risposta, punteggio, problemi, indicizzabilità). Il confronto è limitato a 20.000 pagine per lato; truncated lo segnala. Le liste mostrano al massimo 500 voci.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della scansione di partenza. · 94
to obbligatorio query integer Id della scansione con cui confrontare. · 95

Esempio di risposta

{
    "data": {
        "from": {
            "id": 94,
            "score": 78
        },
        "to": {
            "id": 95,
            "score": 82
        },
        "summary": {
            "pages_from": 118,
            "pages_to": 121,
            "added": 4,
            "removed": 1,
            "changed": 9,
            "score_delta": 4,
            "truncated": false
        },
        "added_pages": [
            {
                "url": "https://lum.it/nuova",
                "status_code": 200,
                "score": 88
            }
        ],
        "removed_pages": [
            {
                "url": "https://lum.it/vecchia",
                "status_code": 200
            }
        ],
        "changed_pages": [
            {
                "url": "https://lum.it/",
                "status_code": {
                    "from": 200,
                    "to": 200
                },
                "score": {
                    "from": 80,
                    "to": 85
                },
                "issues_count": {
                    "from": 3,
                    "to": 1
                },
                "is_indexable": {
                    "from": true,
                    "to": true
                }
            }
        ]
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/spider/94/compare?to=95' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/spider/94/compare?to=95');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/spider/94/compare?to=95', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/spider/94/compare?to=95', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']

GEO / AI

GEO Audit, AI Visibility e ricerche AI

get /geo Elenco dei GEO Audit Chiave API · 200

I tuoi GEO Audit: quanto i siti sono pronti a essere letti e citati dai motori di risposta AI. geo_score è 0-100.

Parametri

NomeDoveTipoDescrizione
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "audit_id": 7,
            "host": "lum.it",
            "url": "https://lum.it",
            "geo_score": 63,
            "has_llms_txt": false,
            "pages_count": 6,
            "datetime": "2026-11-12 09:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/geo' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/geo');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/geo', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/geo', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /geo Avvia un GEO Audit Chiave API · 202

Mette in coda l'audit del dominio (nessun costo esterno, massimo 10 audit all'ora per utente). Risponde 201 con l'id: leggi poi GET /geo/{id} finché non è completato.

Parametri

NomeDoveTipoDescrizione
Idempotency-Key facoltativo platform::docs.ref_in_header string Opzionale. Stringa unica (1-255 caratteri ASCII) scelta da te: ripetendo la richiesta entro 24 ore con la stessa chiave e lo stesso corpo ricevi la risposta originale (Idempotent-Replayed: true) senza duplicare il lavoro; stessa chiave con corpo diverso = 422 idempotency_mismatch.
domain obbligatorio corpo string Dominio o URL da analizzare (anche host/url).

Corpo della richiesta (JSON)

{
    "domain": "lum.it"
}

Esempio di risposta

{
    "data": {
        "audit_id": 8,
        "host": "lum.it",
        "status": "pending"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/geo' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "lum.it"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/geo');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['domain' => 'lum.it']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/geo', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "domain": "lum.it"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/geo', headers={'Authorization': f'Bearer {API_KEY}'}, json={'domain': 'lum.it'})
data = r.json()['data']
get /geo/{id} Dettaglio di un GEO Audit Chiave API · 200

L'audit con matrice dei crawler AI, controlli e correzioni consigliate.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id dell'audit. · 7

Esempio di risposta

{
    "data": {
        "audit_id": 7,
        "host": "lum.it",
        "geo_score": 63,
        "has_llms_txt": false
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/geo/7' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/geo/7');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/geo/7', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/geo/7', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /ai-visibility Elenco misurazioni AI Visibility Chiave API · 200

Le misurazioni di quante volte e dove il brand viene citato nelle risposte AI. Il punteggio è 0-100.

Parametri

NomeDoveTipoDescrizione
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "run_id": 3,
            "brand": "LUM",
            "host": "lum.it",
            "engine": "openai",
            "score": 54,
            "prompts_total": 15,
            "cited_count": 6,
            "first_count": 2,
            "avg_position": 3.2,
            "datetime": "2026-11-10 09:30:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/ai-visibility' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-visibility');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-visibility', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/ai-visibility', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /ai-visibility Avvia una misurazione AI Visibility Chiave API · 202

Mette in coda una misurazione. È a pagamento (chiamate al motore AI): richiede un piano con gli strumenti a pagamento e rispetta i tetti di spesa. Fino a 15 prompt; se non li indichi vengono generati.

Parametri

NomeDoveTipoDescrizione
Idempotency-Key facoltativo platform::docs.ref_in_header string Opzionale. Stringa unica (1-255 caratteri ASCII) scelta da te: ripetendo la richiesta entro 24 ore con la stessa chiave e lo stesso corpo ricevi la risposta originale (Idempotent-Replayed: true) senza duplicare il lavoro; stessa chiave con corpo diverso = 422 idempotency_mismatch.
brand obbligatorio corpo string Nome del brand.
domain facoltativo corpo string Dominio del brand.
prompts facoltativo corpo array Domande da testare.
topic facoltativo corpo string Argomento per generare i prompt.
engine facoltativo corpo string Motore (predefinito openai).

Corpo della richiesta (JSON)

{
    "brand": "LUM",
    "domain": "lum.it",
    "topic": "illuminazione LED"
}

Esempio di risposta

{
    "data": {
        "run_id": 4,
        "status": "pending"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/ai-visibility' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "brand": "LUM",
    "domain": "lum.it",
    "topic": "illuminazione LED"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-visibility');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['brand' => 'LUM', 'domain' => 'lum.it', 'topic' => 'illuminazione LED']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-visibility', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "brand": "LUM",
    "domain": "lum.it",
    "topic": "illuminazione LED"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/ai-visibility', headers={'Authorization': f'Bearer {API_KEY}'}, json={'brand': 'LUM', 'domain': 'lum.it', 'topic': 'illuminazione LED'})
data = r.json()['data']
get /ai-visibility/{id} Dettaglio di una misurazione Chiave API · 200

La misurazione con i prompt testati, se il brand è citato e in che posizione.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della misurazione. · 3

Esempio di risposta

{
    "data": {
        "run_id": 3,
        "brand": "LUM",
        "score": 54
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/ai-visibility/3' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-visibility/3');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-visibility/3', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/ai-visibility/3', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /ai-engine Elenco test AI Engine Chiave API · 200

I test che valutano quanto una pagina risponde bene alle domande, con un punteggio.

Parametri

NomeDoveTipoDescrizione
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "test_id": 2,
            "keyword": "illuminazione led",
            "url": "https://lum.it/led/",
            "score": 71,
            "datetime": "2026-11-09 11:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/ai-engine' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-engine');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-engine', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/ai-engine', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /ai-engine Avvia un test AI Engine Chiave API · 202

Mette in coda un test (a pagamento: usa il motore AI, con i tetti di spesa).

Parametri

NomeDoveTipoDescrizione
Idempotency-Key facoltativo platform::docs.ref_in_header string Opzionale. Stringa unica (1-255 caratteri ASCII) scelta da te: ripetendo la richiesta entro 24 ore con la stessa chiave e lo stesso corpo ricevi la risposta originale (Idempotent-Replayed: true) senza duplicare il lavoro; stessa chiave con corpo diverso = 422 idempotency_mismatch.
url obbligatorio corpo string Pagina da valutare.
keyword facoltativo corpo string Argomento principale.

Corpo della richiesta (JSON)

{
    "url": "https://lum.it/led/",
    "keyword": "illuminazione led"
}

Esempio di risposta

{
    "data": {
        "test_id": 3,
        "status": "pending"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/ai-engine' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://lum.it/led/",
    "keyword": "illuminazione led"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-engine');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['url' => 'https://lum.it/led/', 'keyword' => 'illuminazione led']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-engine', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "url": "https://lum.it/led/",
    "keyword": "illuminazione led"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/ai-engine', headers={'Authorization': f'Bearer {API_KEY}'}, json={'url': 'https://lum.it/led/', 'keyword': 'illuminazione led'})
data = r.json()['data']
get /ai-engine/{id} Dettaglio di un test AI Engine Chiave API · 200

Il test con le domande usate e come la pagina risponde.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del test. · 2

Esempio di risposta

{
    "data": {
        "test_id": 2,
        "score": 71
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/ai-engine/2' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-engine/2');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-engine/2', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/ai-engine/2', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /ai-competitor Elenco report AI Competitor Chiave API · 200

Confronti tra il tuo brand e i concorrenti nelle risposte AI.

Parametri

NomeDoveTipoDescrizione
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "report_id": 1,
            "brand": "LUM",
            "competitors": "Acme, Beta",
            "datetime": "2026-11-08 10:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/ai-competitor' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-competitor');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-competitor', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/ai-competitor', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /ai-competitor Avvia un report AI Competitor Chiave API · 201

Confronta il brand con i concorrenti (a pagamento, con i tetti di spesa).

Parametri

NomeDoveTipoDescrizione
brand obbligatorio corpo string Il tuo brand.
competitors obbligatorio corpo string Concorrenti, separati da virgola.
mode facoltativo corpo string single (predefinito) o symmetric_matrix.

Corpo della richiesta (JSON)

{
    "brand": "LUM",
    "competitors": "Acme, Beta"
}

Esempio di risposta

{
    "data": {
        "report_id": 2,
        "status": "pending"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/ai-competitor' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "brand": "LUM",
    "competitors": "Acme, Beta"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-competitor');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['brand' => 'LUM', 'competitors' => 'Acme, Beta']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-competitor', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "brand": "LUM",
    "competitors": "Acme, Beta"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/ai-competitor', headers={'Authorization': f'Bearer {API_KEY}'}, json={'brand': 'LUM', 'competitors': 'Acme, Beta'})
data = r.json()['data']
get /ai-competitor/{id} Dettaglio di un report AI Competitor Chiave API · 200

Il report con i risultati per ogni concorrente.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del report. · 1

Esempio di risposta

{
    "data": {
        "report_id": 1,
        "brand": "LUM"
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/ai-competitor/1' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/ai-competitor/1');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/ai-competitor/1', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/ai-competitor/1', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /prompt-research Elenco ricerche di prompt Chiave API · 200

Le ricerche che scompongono una domanda in parole chiave, intenti e gruppi.

Parametri

NomeDoveTipoDescrizione
page facoltativo query integer Pagina (da 1). · 1
per_page facoltativo query integer Righe per pagina (1-100, predefinito 25). · 25
format facoltativo query string Con csv restituisce un file CSV (fino a 5000 righe) invece del JSON. · csv

Esempio di risposta

{
    "data": [
        {
            "prompt_id": 1,
            "prompt": "miglior faretto led da incasso",
            "language": "it",
            "datetime": "2026-11-07 15:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total_results": 1,
        "total_pages": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/prompt-research' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/prompt-research');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/prompt-research', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/prompt-research', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /prompt-research Avvia una ricerca di prompt Chiave API · 201

Scompone una domanda (a pagamento, con i tetti di spesa).

Parametri

NomeDoveTipoDescrizione
prompt obbligatorio corpo string La domanda da analizzare.

Corpo della richiesta (JSON)

{
    "prompt": "miglior faretto led da incasso"
}

Esempio di risposta

{
    "data": {
        "prompt_id": 2,
        "status": "pending"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/prompt-research' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "miglior faretto led da incasso"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/prompt-research');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['prompt' => 'miglior faretto led da incasso']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/prompt-research', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "prompt": "miglior faretto led da incasso"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/prompt-research', headers={'Authorization': f'Bearer {API_KEY}'}, json={'prompt': 'miglior faretto led da incasso'})
data = r.json()['data']
get /prompt-research/{id} Dettaglio di una ricerca di prompt Chiave API · 200

La ricerca con parole chiave e intenti estratti.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id della ricerca. · 1

Esempio di risposta

{
    "data": {
        "prompt_id": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/prompt-research/1' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/prompt-research/1');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/prompt-research/1', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/prompt-research/1', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /keyword-research Ricerca keyword Chiave API · 200

Dati di mercato su una keyword (o su un elenco): volume, difficoltà e correlate. A pagamento (DataForSEO): consuma crediti.

Parametri

NomeDoveTipoDescrizione
keyword facoltativo corpo string Una keyword.
keywords facoltativo corpo array Elenco di keyword (analisi in blocco).
location_code facoltativo corpo integer Codice location.
language_code facoltativo corpo string Codice lingua.

Corpo della richiesta (JSON)

{
    "keyword": "illuminazione led",
    "location_code": 2380,
    "language_code": "it"
}

Esempio di risposta

{
    "data": {
        "keyword": "illuminazione led",
        "search_volume": 1900
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/keyword-research' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "keyword": "illuminazione led",
    "location_code": 2380,
    "language_code": "it"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/keyword-research');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['keyword' => 'illuminazione led', 'location_code' => 2380, 'language_code' => 'it']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/keyword-research', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "keyword": "illuminazione led",
    "location_code": 2380,
    "language_code": "it"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/keyword-research', headers={'Authorization': f'Bearer {API_KEY}'}, json={'keyword': 'illuminazione led', 'location_code': 2380, 'language_code': 'it'})
data = r.json()['data']

Audit

Siti, analisi e storico

get /websites Elenco dei siti Chiave API · 200

I siti che monitori con l'Audit, con punteggio e conteggio dei problemi. Forma e parametri compatibili con l'API del vecchio sito.

Parametri

NomeDoveTipoDescrizione
search facoltativo query string Testo da cercare. · lum
search_by facoltativo query string Campo in cui cercare: host. · host
domain_id facoltativo query integer Solo i siti di questo dominio. · 0
page facoltativo query integer Pagina (da 1). · 1
results_per_page facoltativo query integer Righe per pagina: 10, 25, 50, 100, 250, 500 o 1000 (predefinito 25). · 25
order_by facoltativo query string Campo di ordinamento tra quelli consentiti per la risorsa; un valore non valido viene ignorato. · datetime
order_type facoltativo query string ASC o DESC. · DESC
datetime_field facoltativo query string Campo data da filtrare (con datetime_start e datetime_end). · datetime
datetime_start facoltativo query string Data iniziale YYYY-MM-DD HH:MM:SS. · 2026-11-01 00:00:00
datetime_end facoltativo query string Data finale YYYY-MM-DD HH:MM:SS. · 2026-11-30 23:59:59

Esempio di risposta

{
    "data": [
        {
            "id": 5,
            "user_id": 1,
            "domain_id": 0,
            "scheme": "https://",
            "host": "lum.it",
            "sitemap_url": "https://lum.it/sitemap.xml",
            "total_sitemap_urls": 120,
            "score": 78,
            "total_audits": 12,
            "total_archived_audits": 340,
            "total_issues": 9,
            "major_issues": 1,
            "moderate_issues": 3,
            "minor_issues": 5,
            "last_audit_datetime": "2026-11-12 02:00:00",
            "datetime": "2026-07-18 10:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "total_pages": 1,
        "results_per_page": 25,
        "total_results": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/websites' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/websites');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/websites', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/websites', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /websites/{id} Dettaglio sito Chiave API · 200

Un sito con punteggio, problemi per gravità e date dell'ultimo controllo.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del sito. · 5

Esempio di risposta

{
    "data": {
        "id": 5,
        "user_id": 1,
        "domain_id": 0,
        "scheme": "https://",
        "host": "lum.it",
        "sitemap_url": "https://lum.it/sitemap.xml",
        "total_sitemap_urls": 120,
        "score": 78,
        "total_audits": 12,
        "total_archived_audits": 340,
        "total_issues": 9,
        "major_issues": 1,
        "moderate_issues": 3,
        "minor_issues": 5,
        "last_audit_datetime": "2026-11-12 02:00:00",
        "datetime": "2026-07-18 10:00:00"
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/websites/5' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/websites/5');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/websites/5', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/websites/5', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /websites/{id} Aggiorna sito (compatibilità) Chiave API · 200

Identico a PATCH /websites/{id}: esiste perché l'app e il vecchio sito aggiornavano con POST.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del sito. · 5
sitemap_url facoltativo corpo string Sitemap.
notifications facoltativo corpo array Id dei gestori di notifica.
audit_check_interval facoltativo corpo integer Intervallo di controllo in secondi (0 = mai).

Corpo della richiesta (JSON)

{
    "audit_check_interval": 86400
}

Esempio di risposta

{
    "data": {
        "id": 5,
        "user_id": 1,
        "domain_id": 0,
        "scheme": "https://",
        "host": "lum.it",
        "sitemap_url": "https://lum.it/sitemap.xml",
        "total_sitemap_urls": 120,
        "score": 78,
        "total_audits": 12,
        "total_archived_audits": 340,
        "total_issues": 9,
        "major_issues": 1,
        "moderate_issues": 3,
        "minor_issues": 5,
        "last_audit_datetime": "2026-11-12 02:00:00",
        "datetime": "2026-07-18 10:00:00"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/websites/5' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "audit_check_interval": 86400
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/websites/5');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['audit_check_interval' => 86400]),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/websites/5', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "audit_check_interval": 86400
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/websites/5', headers={'Authorization': f'Bearer {API_KEY}'}, json={'audit_check_interval': 86400})
data = r.json()['data']
patch /websites/{id} Aggiorna un sito Chiave API · 200

Modifica dominio collegato, sitemap, notifiche, intervallo di controllo, visibilità pubblica e password. Le modifiche valgono anche per le pagine del sito.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del sito. · 5
domain_id facoltativo corpo integer Dominio collegato (uno non tuo diventa nullo).
sitemap_url facoltativo corpo string Sitemap.
notifications facoltativo corpo array Id dei gestori di notifica.
audit_check_interval facoltativo corpo integer Intervallo di controllo in secondi.
notifications_mode facoltativo corpo string always o changes.
is_public facoltativo corpo boolean Pagina pubblica.
password facoltativo corpo string Password della pagina pubblica.

Corpo della richiesta (JSON)

{
    "notifications_mode": "changes"
}

Esempio di risposta

{
    "data": {
        "id": 5,
        "user_id": 1,
        "domain_id": 0,
        "scheme": "https://",
        "host": "lum.it",
        "sitemap_url": "https://lum.it/sitemap.xml",
        "total_sitemap_urls": 120,
        "score": 78,
        "total_audits": 12,
        "total_archived_audits": 340,
        "total_issues": 9,
        "major_issues": 1,
        "moderate_issues": 3,
        "minor_issues": 5,
        "last_audit_datetime": "2026-11-12 02:00:00",
        "datetime": "2026-07-18 10:00:00"
    }
}

Esempi di codice

curl -X PATCH 'https://seo.gtechgroup.it/api/v1/websites/5' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "notifications_mode": "changes"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/websites/5');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['notifications_mode' => 'changes']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/websites/5', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "notifications_mode": "changes"
}),
});
const { data } = await res.json();
import requests

r = requests.patch('https://seo.gtechgroup.it/api/v1/websites/5', headers={'Authorization': f'Bearer {API_KEY}'}, json={'notifications_mode': 'changes'})
data = r.json()['data']
delete /websites/{id} Elimina un sito Chiave API · 200

Elimina il sito con le sue pagine e lo storico.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id del sito. · 5

Esempio di risposta

{
    "data": {
        "id": 5
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/websites/5' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/websites/5');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/websites/5', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/websites/5', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /audits Elenco delle pagine analizzate Chiave API · 200

Le pagine analizzate dall'Audit con punteggio e problemi. Con slim=1 omette il blocco data (molto pesante) per liste più veloci.

Parametri

NomeDoveTipoDescrizione
website_id facoltativo query integer Solo le pagine di questo sito. · 5
domain_id facoltativo query integer Solo di questo dominio. · 0
search facoltativo query string Testo da cercare. · led
search_by facoltativo query string Campo: url, host o title. · url
slim facoltativo query integer Con 1 omette data. · 1
page facoltativo query integer Pagina (da 1). · 1
results_per_page facoltativo query integer Righe per pagina: 10, 25, 50, 100, 250, 500 o 1000 (predefinito 25). · 25
order_by facoltativo query string Campo di ordinamento tra quelli consentiti per la risorsa; un valore non valido viene ignorato. · datetime
order_type facoltativo query string ASC o DESC. · DESC
datetime_field facoltativo query string Campo data da filtrare (con datetime_start e datetime_end). · datetime
datetime_start facoltativo query string Data iniziale YYYY-MM-DD HH:MM:SS. · 2026-11-01 00:00:00
datetime_end facoltativo query string Data finale YYYY-MM-DD HH:MM:SS. · 2026-11-30 23:59:59

Esempio di risposta

{
    "data": [
        {
            "id": 9,
            "website_id": 5,
            "host": "lum.it",
            "url": "https://lum.it/",
            "is_https": true,
            "is_ssl_valid": true,
            "http_protocol": 2,
            "title": "Illuminazione LED | LUM",
            "meta_description": "Soluzioni di illuminazione...",
            "score": 78,
            "total_tests": 120,
            "passed_tests": 111,
            "total_issues": 9,
            "major_issues": 1,
            "moderate_issues": 3,
            "minor_issues": 5,
            "is_queued": false,
            "refresh_error": null,
            "last_refresh_datetime": "2026-11-12 02:00:00",
            "datetime": "2026-07-18 10:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "total_pages": 1,
        "results_per_page": 25,
        "total_results": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/audits' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/audits');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/audits', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/audits', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /audits Avvia un'analisi Chiave API · 202

Mette in coda l'analisi di una pagina (single), di un elenco (bulk, un URL per riga) o di una sitemap (sitemap). Risponde 201 subito: i campi dell'analisi restano vuoti con is_queued: true; rileggi con GET /audits/{id} finché is_queued è false. Rispetta i limiti del piano (403 con code) e rifiuta gli indirizzi interni (422).

Parametri

NomeDoveTipoDescrizione
Idempotency-Key facoltativo platform::docs.ref_in_header string Opzionale. Stringa unica (1-255 caratteri ASCII) scelta da te: ripetendo la richiesta entro 24 ore con la stessa chiave e lo stesso corpo ricevi la risposta originale (Idempotent-Replayed: true) senza duplicare il lavoro; stessa chiave con corpo diverso = 422 idempotency_mismatch.
type facoltativo corpo string single (predefinito), bulk o sitemap.
url facoltativo corpo string URL da analizzare (type single).
urls facoltativo corpo string Elenco di URL, uno per riga (bulk) o URL della sitemap.
domain_id facoltativo corpo integer Dominio collegato.
audit_check_interval facoltativo corpo integer Ripeti ogni N secondi.
notifications facoltativo corpo array Id dei gestori di notifica.
is_public facoltativo corpo boolean Pagina pubblica.

Corpo della richiesta (JSON)

{
    "type": "single",
    "url": "https://lum.it/"
}

Esempio di risposta

{
    "data": {
        "id": 9,
        "website_id": 5,
        "host": "lum.it",
        "url": "https://lum.it/",
        "is_https": true,
        "is_ssl_valid": true,
        "http_protocol": 2,
        "title": "Illuminazione LED | LUM",
        "meta_description": "Soluzioni di illuminazione...",
        "score": 78,
        "total_tests": 120,
        "passed_tests": 111,
        "total_issues": 9,
        "major_issues": 1,
        "moderate_issues": 3,
        "minor_issues": 5,
        "is_queued": false,
        "refresh_error": null,
        "last_refresh_datetime": "2026-11-12 02:00:00",
        "datetime": "2026-07-18 10:00:00"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/audits' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "single",
    "url": "https://lum.it/"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/audits');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['type' => 'single', 'url' => 'https://lum.it/']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/audits', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "type": "single",
    "url": "https://lum.it/"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/audits', headers={'Authorization': f'Bearer {API_KEY}'}, json={'type': 'single', 'url': 'https://lum.it/'})
data = r.json()['data']
get /audits/{id} Dettaglio analisi Chiave API · 200

L'analisi completa: punteggio, problemi per gravità, blocco data con tutti i controlli.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id dell'analisi. · 9

Esempio di risposta

{
    "data": {
        "id": 9,
        "website_id": 5,
        "host": "lum.it",
        "url": "https://lum.it/",
        "is_https": true,
        "is_ssl_valid": true,
        "http_protocol": 2,
        "title": "Illuminazione LED | LUM",
        "meta_description": "Soluzioni di illuminazione...",
        "score": 78,
        "total_tests": 120,
        "passed_tests": 111,
        "total_issues": 9,
        "major_issues": 1,
        "moderate_issues": 3,
        "minor_issues": 5,
        "is_queued": false,
        "refresh_error": null,
        "last_refresh_datetime": "2026-11-12 02:00:00",
        "datetime": "2026-07-18 10:00:00"
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/audits/9' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/audits/9');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/audits/9', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/audits/9', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /audits/{id} Aggiorna analisi (compatibilità) Chiave API · 200

Identico a PATCH /audits/{id}.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id dell'analisi. · 9
audit_check_interval facoltativo corpo integer

Corpo della richiesta (JSON)

{
    "audit_check_interval": 604800
}

Esempio di risposta

{
    "data": {
        "id": 9,
        "website_id": 5,
        "host": "lum.it",
        "url": "https://lum.it/",
        "is_https": true,
        "is_ssl_valid": true,
        "http_protocol": 2,
        "title": "Illuminazione LED | LUM",
        "meta_description": "Soluzioni di illuminazione...",
        "score": 78,
        "total_tests": 120,
        "passed_tests": 111,
        "total_issues": 9,
        "major_issues": 1,
        "moderate_issues": 3,
        "minor_issues": 5,
        "is_queued": false,
        "refresh_error": null,
        "last_refresh_datetime": "2026-11-12 02:00:00",
        "datetime": "2026-07-18 10:00:00"
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/audits/9' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "audit_check_interval": 604800
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/audits/9');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['audit_check_interval' => 604800]),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/audits/9', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "audit_check_interval": 604800
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/audits/9', headers={'Authorization': f'Bearer {API_KEY}'}, json={'audit_check_interval': 604800})
data = r.json()['data']
patch /audits/{id} Aggiorna un'analisi Chiave API · 200

Modifica dominio, visibilità pubblica, password, intervallo di ripetizione e notifiche.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id dell'analisi. · 9
domain_id facoltativo corpo integer Dominio collegato.
is_public facoltativo corpo boolean Pagina pubblica.
password facoltativo corpo string Password.
audit_check_interval facoltativo corpo integer Intervallo in secondi.
notifications facoltativo corpo array Gestori di notifica.
notifications_mode facoltativo corpo string always o changes.

Corpo della richiesta (JSON)

{
    "audit_check_interval": 604800
}

Esempio di risposta

{
    "data": {
        "id": 9,
        "website_id": 5,
        "host": "lum.it",
        "url": "https://lum.it/",
        "is_https": true,
        "is_ssl_valid": true,
        "http_protocol": 2,
        "title": "Illuminazione LED | LUM",
        "meta_description": "Soluzioni di illuminazione...",
        "score": 78,
        "total_tests": 120,
        "passed_tests": 111,
        "total_issues": 9,
        "major_issues": 1,
        "moderate_issues": 3,
        "minor_issues": 5,
        "is_queued": false,
        "refresh_error": null,
        "last_refresh_datetime": "2026-11-12 02:00:00",
        "datetime": "2026-07-18 10:00:00"
    }
}

Esempi di codice

curl -X PATCH 'https://seo.gtechgroup.it/api/v1/audits/9' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "audit_check_interval": 604800
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/audits/9');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['audit_check_interval' => 604800]),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/audits/9', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "audit_check_interval": 604800
}),
});
const { data } = await res.json();
import requests

r = requests.patch('https://seo.gtechgroup.it/api/v1/audits/9', headers={'Authorization': f'Bearer {API_KEY}'}, json={'audit_check_interval': 604800})
data = r.json()['data']
delete /audits/{id} Elimina un'analisi Chiave API · 200

Elimina l'analisi e il suo storico.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id dell'analisi. · 9

Esempio di risposta

{
    "data": {
        "id": 9
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/audits/9' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/audits/9');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/audits/9', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/audits/9', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /archived-audits Storico delle analisi Chiave API · 200

Le versioni precedenti delle analisi, per vedere come cambia il sito nel tempo. Conservate secondo il tuo piano (predefinito 90 giorni).

Parametri

NomeDoveTipoDescrizione
website_id facoltativo query integer Solo di questo sito. · 5
audit_id facoltativo query integer Solo di questa analisi. · 9
domain_id facoltativo query integer Solo di questo dominio. · 0
search facoltativo query string Testo da cercare. · led
search_by facoltativo query string Campo: url, host o title. · url
slim facoltativo query integer Con 1 omette data. · 1
page facoltativo query integer Pagina (da 1). · 1
results_per_page facoltativo query integer Righe per pagina: 10, 25, 50, 100, 250, 500 o 1000 (predefinito 25). · 25
order_by facoltativo query string Campo di ordinamento tra quelli consentiti per la risorsa; un valore non valido viene ignorato. · datetime
order_type facoltativo query string ASC o DESC. · DESC
datetime_field facoltativo query string Campo data da filtrare (con datetime_start e datetime_end). · datetime
datetime_start facoltativo query string Data iniziale YYYY-MM-DD HH:MM:SS. · 2026-11-01 00:00:00
datetime_end facoltativo query string Data finale YYYY-MM-DD HH:MM:SS. · 2026-11-30 23:59:59

Esempio di risposta

{
    "data": [
        {
            "id": 31,
            "audit_id": 9,
            "website_id": 5,
            "host": "lum.it",
            "url": "https://lum.it/",
            "score": 76,
            "datetime": "2026-11-05 02:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "total_pages": 1,
        "results_per_page": 25,
        "total_results": 1
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/archived-audits' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/archived-audits');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/archived-audits', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/archived-audits', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /archived-audits/{id} Dettaglio analisi archiviata Chiave API · 200

Una versione precedente con il blocco data (nullo se è stato eliminato dalla pulizia).

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id dell'analisi archiviata. · 31

Esempio di risposta

{
    "data": {
        "id": 31,
        "audit_id": 9,
        "score": 76
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/archived-audits/31' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/archived-audits/31');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/archived-audits/31', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/archived-audits/31', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
delete /archived-audits/{id} Elimina analisi archiviata Chiave API · 200

Elimina una versione dallo storico.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id dell'analisi archiviata. · 31

Esempio di risposta

{
    "data": {
        "id": 31
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/archived-audits/31' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/archived-audits/31');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/archived-audits/31', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/archived-audits/31', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']

Google

Search Console e Analytics dal vivo

get /search-console Search Console: ricerche e pagine Chiave API · 200

Dati dal vivo di Google Search Console per il tuo account Google collegato. Senza dimensions restituisce un riepilogo (totali, prime 25 ricerche, prime 25 pagine) in cache 3 ore. Con dimensions restituisce righe personalizzate. ctr è in percentuale, position è la posizione media. Il sito deve essere una proprietà del tuo account (altrimenti 422); se Google non è collegato risponde 409.

Parametri

NomeDoveTipoDescrizione
site facoltativo query string Proprietà (vedi /search-console/sites); se ne hai una sola è opzionale. · sc-domain:lum.it
range facoltativo query integer Giorni: 7, 28 (predefinito) o 90. · 28
dimensions facoltativo query string Elenco tra query,page,country,device,date,searchAppearance. · query,page
row_limit facoltativo query integer Righe (1-1000, predefinito 100; solo con dimensions). · 100
search_type facoltativo query string web, image, video, news, discover, googleNews. · web
query_filter facoltativo query string Solo le ricerche che contengono questo testo. · led
page_filter facoltativo query string Solo le pagine il cui URL contiene questo testo. · /blog/
country facoltativo query string Paese (codice a 3 lettere, es. ita). · ita
device facoltativo query string DESKTOP, MOBILE o TABLET. · MOBILE

Esempio di risposta

{
    "data": {
        "site": "sc-domain:lum.it",
        "range_days": 28,
        "start": "2026-10-14",
        "end": "2026-11-10",
        "totals": {
            "clicks": 412,
            "impressions": 18200,
            "ctr": 2.26,
            "position": 14.1
        },
        "queries": [
            {
                "keys": [
                    "illuminazione led"
                ],
                "clicks": 55,
                "impressions": 2100,
                "ctr": 2.62,
                "position": 6.8
            }
        ],
        "pages": []
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/search-console' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/search-console');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/search-console', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/search-console', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /search-console/sites Proprietà di Search Console Chiave API · 200

Le proprietà dell'account Google collegato (dominio sc-domain: o prefisso URL). Il valore va passato come site alle altre chiamate. In cache 6 ore.

Esempio di risposta

{
    "data": [
        "sc-domain:lum.it",
        "https://www.esempio.it/"
    ]
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/search-console/sites' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/search-console/sites');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/search-console/sites', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/search-console/sites', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /analytics Google Analytics 4 dal vivo Chiave API · 200

Metriche GA4 per una proprietà del tuo account Google collegato. Senza metrics restituisce un riepilogo (sessioni, utenti attivi, nuovi utenti, visualizzazioni e altro) in cache 3 ore; con metrics (e dimensions) un report personalizzato, solo con valori della lista supportata. Il valore property deve essere una delle tue proprietà (altrimenti 422).

Parametri

NomeDoveTipoDescrizione
property facoltativo query string Id proprietà GA4 (solo cifre; vedi /analytics/properties). · 123456789
range facoltativo query integer Giorni: 7, 28 o 90. · 28
metrics facoltativo query string Metriche GA4 separate da virgola. · sessions,activeUsers
dimensions facoltativo query string Dimensioni GA4 separate da virgola. · sessionDefaultChannelGroup
order_by facoltativo query string Metrica per ordinare. · sessions
limit facoltativo query integer Righe massime. · 25

Esempio di risposta

{
    "data": {
        "property": "123456789",
        "range_days": 28,
        "start": "2026-10-14",
        "end": "2026-11-10",
        "totals": {
            "sessions": 1500,
            "active_users": 1100,
            "new_users": 900,
            "page_views": 4200
        }
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/analytics' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/analytics');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/analytics', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/analytics', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
get /analytics/properties Proprietà di Analytics Chiave API · 200

Le proprietà GA4 dell'account Google collegato. In cache 6 ore.

Esempio di risposta

{
    "data": [
        {
            "property": "123456789",
            "name": "lum.it"
        }
    ]
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/analytics/properties' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/analytics/properties');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/analytics/properties', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/analytics/properties', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']

Notifiche

Avvisi

get /alerts Elenco degli avvisi Chiave API · 200

Gli avvisi generati dai controlli (cali di posizione, regressioni, problemi nuovi).

Parametri

NomeDoveTipoDescrizione
is_read facoltativo query integer 0 solo non letti, 1 solo letti. · 0

Esempio di risposta

{
    "data": [
        {
            "id": 20,
            "type": "rank_drop",
            "severity": "warning",
            "message": "La keyword \"illuminazione led\" è scesa di 4 posizioni",
            "is_read": false,
            "datetime": "2026-11-12 06:15:00"
        }
    ]
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/alerts' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/alerts');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/alerts', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/alerts', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
patch /alerts Segna tutti gli avvisi Chiave API · 200

Imposta lo stato letto/non letto di tutti i tuoi avvisi.

Parametri

NomeDoveTipoDescrizione
is_read facoltativo corpo boolean Valore da impostare (predefinito vero).

Corpo della richiesta (JSON)

{
    "is_read": true
}

Esempio di risposta

{
    "data": {
        "updated": "all",
        "is_read": true
    }
}

Esempi di codice

curl -X PATCH 'https://seo.gtechgroup.it/api/v1/alerts' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_read": true
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/alerts');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['is_read' => true]),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/alerts', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "is_read": true
}),
});
const { data } = await res.json();
import requests

r = requests.patch('https://seo.gtechgroup.it/api/v1/alerts', headers={'Authorization': f'Bearer {API_KEY}'}, json={'is_read': True})
data = r.json()['data']
patch /alerts/{id} Segna un avviso Chiave API · 200

Imposta lo stato letto/non letto di un avviso.

Parametri

NomeDoveTipoDescrizione
id obbligatorio percorso integer Id dell'avviso. · 20
is_read facoltativo corpo boolean Valore da impostare (predefinito vero).

Corpo della richiesta (JSON)

{
    "is_read": true
}

Esempio di risposta

{
    "data": {
        "id": 20,
        "is_read": true
    }
}

Esempi di codice

curl -X PATCH 'https://seo.gtechgroup.it/api/v1/alerts/20' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_read": true
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/alerts/20');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['is_read' => true]),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/alerts/20', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "is_read": true
}),
});
const { data } = await res.json();
import requests

r = requests.patch('https://seo.gtechgroup.it/api/v1/alerts/20', headers={'Authorization': f'Bearer {API_KEY}'}, json={'is_read': True})
data = r.json()['data']

Account

Chiave API e dispositivi

get /api-key Chiave in uso (mascherata) Chiave API · 200

Mostra solo un suggerimento della chiave con cui chiami (ultimi caratteri): i segreti non sono mai recuperabili.

Esempio di risposta

{
    "data": {
        "api_key_masked": "****************a1b2"
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/api-key' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/api-key');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/api-key', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/api-key', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /api-key/rotate Ruota la chiave Chiave API · 200

Emette una nuova chiave e revoca quella in uso. La nuova chiave compare una sola volta: salvala subito.

Esempio di risposta

{
    "data": {
        "api_key": "2|ZyXwVu9876543210..."
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/api-key/rotate' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/api-key/rotate');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/api-key/rotate', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/api-key/rotate', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']
post /device-tokens Registra un dispositivo per le notifiche Chiave API · 200

Registra il token FCM di un dispositivo per le notifiche push dell'app.

Parametri

NomeDoveTipoDescrizione
token obbligatorio corpo string Token FCM.
platform facoltativo corpo string Piattaforma (predefinito android).
app_version facoltativo corpo string Versione dell'app.

Corpo della richiesta (JSON)

{
    "token": "fcm-token-di-esempio",
    "platform": "android",
    "app_version": "0.14.4"
}

Esempio di risposta

{
    "data": {
        "registered": true
    }
}

Esempi di codice

curl -X POST 'https://seo.gtechgroup.it/api/v1/device-tokens' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "fcm-token-di-esempio",
    "platform": "android",
    "app_version": "0.14.4"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/device-tokens');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['token' => 'fcm-token-di-esempio', 'platform' => 'android', 'app_version' => '0.14.4']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/device-tokens', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "token": "fcm-token-di-esempio",
    "platform": "android",
    "app_version": "0.14.4"
}),
});
const { data } = await res.json();
import requests

r = requests.post('https://seo.gtechgroup.it/api/v1/device-tokens', headers={'Authorization': f'Bearer {API_KEY}'}, json={'token': 'fcm-token-di-esempio', 'platform': 'android', 'app_version': '0.14.4'})
data = r.json()['data']
delete /device-tokens Rimuove un dispositivo Chiave API · 200

Rimuove un token FCM, indicato nel corpo o in ?token=.

Parametri

NomeDoveTipoDescrizione
token facoltativo query string Token FCM (in alternativa al corpo). · fcm-token-di-esempio
token facoltativo corpo string Token FCM.

Corpo della richiesta (JSON)

{
    "token": "fcm-token-di-esempio"
}

Esempio di risposta

{
    "data": {
        "unregistered": true
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/device-tokens' \
  -H 'Authorization: Bearer $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "token": "fcm-token-di-esempio"
}'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/device-tokens');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['token' => 'fcm-token-di-esempio']),
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/device-tokens', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "token": "fcm-token-di-esempio"
}),
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/device-tokens', headers={'Authorization': f'Bearer {API_KEY}'}, json={'token': 'fcm-token-di-esempio'})
data = r.json()['data']
delete /device-tokens/{token} Rimuove un dispositivo (percorso) Chiave API · 200

Come DELETE /device-tokens, con il token nel percorso.

Parametri

NomeDoveTipoDescrizione
token obbligatorio percorso string Token FCM. · fcm-token-di-esempio

Esempio di risposta

{
    "data": {
        "unregistered": true
    }
}

Esempi di codice

curl -X DELETE 'https://seo.gtechgroup.it/api/v1/device-tokens/fcm-token-di-esempio' \
  -H 'Authorization: Bearer $API_KEY'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/device-tokens/fcm-token-di-esempio');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer '.$apiKey],
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/device-tokens/fcm-token-di-esempio', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${API_KEY}`
  },
});
const { data } = await res.json();
import requests

r = requests.delete('https://seo.gtechgroup.it/api/v1/device-tokens/fcm-token-di-esempio', headers={'Authorization': f'Bearer {API_KEY}'})
data = r.json()['data']

Spiegazioni

Testi "cosa significa" per punteggi e metriche

get /explain Elenco delle spiegazioni disponibili Pubblico · 200

Elenca le chiavi dei testi "cosa significa" (punteggi e metriche) con il titolo e una riga di sintesi. Contenuto statico, senza autenticazione.

Parametri

NomeDoveTipoDescrizione
lang facoltativo query string it (predefinito) o en. · it

Esempio di risposta

{
    "data": [
        {
            "key": "geo_score",
            "title": "Punteggio GEO",
            "short": "Quanto il sito è pronto a essere letto e citato dai motori di risposta AI (0-100)."
        }
    ]
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/explain'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/explain');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/explain', {
  method: 'GET',
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/explain')
data = r.json()['data']
get /explain/{key} Spiegazione di un punteggio o di una metrica Pubblico · 200

Restituisce titolo, sintesi, spiegazione estesa, perché conta e come migliorare. Contenuto statico, senza autenticazione; chiave sconosciuta = 404.

Parametri

NomeDoveTipoDescrizione
key obbligatorio percorso string Chiave (es. geo_score). · geo_score
lang facoltativo query string it (predefinito) o en. · it

Esempio di risposta

{
    "data": {
        "key": "geo_score",
        "title": "Punteggio GEO",
        "short": "…",
        "long": "…",
        "why_it_matters": "…",
        "how_to_improve": "…"
    }
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/explain/geo_score'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/explain/geo_score');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/explain/geo_score', {
  method: 'GET',
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/explain/geo_score')
data = r.json()['data']

Operativita

Controlli di salute

get /health Controllo di salute pubblico Pubblico · 200

Risponde {"status":"ok"} se l'applicazione è raggiungibile. Non richiede autenticazione e non espone dettagli.

Esempio di risposta

{
    "status": "ok"
}

Esempi di codice

curl -X GET 'https://seo.gtechgroup.it/api/v1/health'
$ch = curl_init('https://seo.gtechgroup.it/api/v1/health');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
]);
$risposta = json_decode(curl_exec($ch), true); // {"data": ...}
curl_close($ch);
const res = await fetch('https://seo.gtechgroup.it/api/v1/health', {
  method: 'GET',
});
const { data } = await res.json();
import requests

r = requests.get('https://seo.gtechgroup.it/api/v1/health')
data = r.json()['data']