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
- Dal tuo account, nella pagina delle chiavi API: puoi crearne una nuova, ruotarla o revocarla.
- Con
POST /auth/login(email e password, piùtwofa_tokense hai la 2FA): restituisce la chiave nel campoapi_key. POST /api-key/rotateemette una nuova chiave e revoca quella in uso; la chiave compare una sola volta, salvala subito.DELETE /auth/tokenla revoca.
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
200 | OK. |
201 | Creato (o messo in coda: vedi "Operazioni lunghe"). |
401 | Chiave mancante o non valida, account non attivo, piano senza API. |
403 | Operazione non consentita dal piano (limite raggiunto, strumento a pagamento). |
404 | La risorsa non esiste o non è tua. |
409 | Integrazione non collegata (per esempio Google o DataForSEO). |
422 | Dati non validi. |
429 | Troppe richieste: aspetta e riprova. |
501 | Funzione non disponibile su questa installazione. |
503 | Servizio 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.
POST /auditsrisponde 201 conis_queued: true; rileggiGET /audits/{id}finchéis_queueddiventafalse.POST /spiderrestituiscescan_id; rileggiGET /spider/{id}finchéstatusècompleted.POST /georestituisceaudit_id; rileggiGET /geo/{id}.
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_key | Manca l'intestazione Authorization: Bearer. |
invalid_key | Chiave API sconosciuta, scaduta o revocata. |
inactive_account | Account non attivo. |
plan_no_api | Il piano non include l'API (403 su /api/v1, 401 sui percorsi legacy). |
insufficient_scope | La chiave non ha l'ambito richiesto (read, write, admin). |
quota_exceeded | Credito o quota esaurita (es. 402 DataForSEO). |
validation_failed | Dati non validi (422): vedi `fields`. |
throttled | Troppe richieste (429): vedi `Retry-After`. |
not_found | Risorsa inesistente o non tua. |
not_implemented | Azione non disponibile (501). |
idempotency_mismatch | Idempotency-Key gia' usata con un corpo diverso (422). |
idempotency_in_progress | Una richiesta con la stessa Idempotency-Key e' ancora in corso (409). |
idempotency_key_invalid | Idempotency-Key non valida (422). |
payload_too_large | Corpo troppo grande (413). |
twofa_required | Serve il codice a due fattori (login). |
twofa_invalid | Codice 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.
| key | Descrizione |
|---|---|
geo_score | Punteggio GEO |
avg_page_score | Media del punteggio delle pagine (GEO) |
site_penalties | Penalità di sito (GEO) |
ai_crawlers | Accesso dei crawler AI |
llms_txt | File llms.txt |
entity_schema | Entità del sito (schema Organization) |
geo_scoring_version | Versione del calcolo GEO |
g_score | G Score |
audit_score | Punteggio dell'Audit |
spider_score | Punteggio di una pagina (Spider) |
issue_severity | Gravità dei problemi |
visibility_score | Punteggio AI Visibility |
share_of_voice | Quota di presenza (Share of Voice) |
citation_position | Posizione di citazione |
position_buckets | Fasce di posizione |
gained_lost | Keyword guadagnate e perse |
avg_position | Posizione media |
search_volume | Volume di ricerca |
impressions | Impressioni |
clicks | Clic |
ctr | CTR (percentuale di clic) |
ttfb | Tempo di prima risposta (TTFB) |
link_graph | Grafo 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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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']
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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
| Nome | Dove | Tipo | Descrizione |
|---|---|---|---|
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']
Nessuna operazione corrisponde alla ricerca.
