G Tech Group

GTG SEO API: developer guide

A REST API to read and manage from your own code what you see in the application: projects and rankings, Spider scans, GEO Audit, AI Visibility, sites and analyses, Search Console and Analytics data.

Introduction

The API is meant for automations (scripts, dashboards, internal tools) and for apps connected to the service. Everything it does concerns your account data: you cannot read or change other users' data, and someone else's resource answers as if it did not exist (404).

Base URL: https://seo.gtechgroup.it/api/v1

Versions and paths

The current version is v1 and the canonical path is /api/v1/.... For compatibility the same resources also answer on /api/seo/... and /api/v1/seo/... (used by the Android app) and, for sites, analyses and history, on the old site's paths: /api/websites, /api/audits, /api/archived-audits. All paths on this page are relative to /api/v1.

Authentication

Every call (except login, explanations and the health check) requires an API key in the Authorization header: Authorization: Bearer <key>.

How to get a key

The key is the equivalent of your password for the API: do not put it in repositories or public pages. Keys are stored only as hashes; if you lose it, it cannot be recovered and a new one is issued. If the account is disabled or the plan does not include API access the response is 401.

Technical note: the key is a Sanctum token; keys from the old site were imported and keep working.

Quick start

Three calls to see that everything works. Replace $API_KEY with your key.

1. Check the key

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

2. Create a rank-tracker project

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. Add keywords and read the project

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
    }
}

Responses and errors

Successful responses always look like {"data": ..., "meta": {...}}; meta appears on paginated lists and holds page, per_page, total_results and total_pages. Errors look like {"errors": [{"title": "...", "status": "422"}]} and sometimes carry a machine-readable code field (for example quota, twofa_required).

Status codes

200OK.
201Created (or queued: see "Long operations").
401Missing or invalid key, inactive account, plan without API.
403Operation not allowed by the plan (limit reached, paid tool).
404The resource does not exist or is not yours.
409Integration not connected (for example Google or DataForSEO).
422Invalid data.
429Too many requests: wait and retry.
501Feature not available on this installation.
503External service not configured.

Lists, pagination, filters and sorting

Rank tracker, Spider and GEO/AI lists use page and per_page (maximum 100, default 25). With format=csv you get a CSV file (up to 5000 rows) instead of JSON.

Sites, analyses and history (/websites, /audits, /archived-audits) use the old site's shape: page, results_per_page (10, 25, 50, 100, 250, 500 or 1000), search with search_by, order_by with order_type (ASC/DESC), id filters (website_id, domain_id, audit_id) and the date range with datetime_field, datetime_start and datetime_end. The response also carries links (first, last, next, prev, self) besides meta. An unexpected sort value is ignored, without error.

Long operations and the queue

Operations that take time (new analysis, Spider crawl, GEO Audit, AI measurements, rank refresh) do not wait for the result: on /api/v1 they answer immediately with 202 Accepted, a Location header (the URL to read) and status: "queued"; the work continues in the queue. To know when it is done, GET the resource until its status changes. The legacy paths used by the Android app (/api/seo, /api/v1/seo, bare paths) keep their historic 200/201 codes.

To avoid duplicates when you repeat a call (timeouts, flaky network) send Idempotency-Key: <unique value>: within 24 hours the same key with the same body returns the original response (Idempotent-Replayed: true) without queuing the work again; with a different body it answers 422 idempotency_mismatch. Paid tools (keyword research, AI measurements and research) use credits or AI budget and respect spending caps; the API has no confirmation step like the app, so use them deliberately.

Limits

Authenticated calls are limited to 60 per minute per user (429 beyond the limit, with Retry-After). Expensive operations (new crawl, audit, AI analysis, refresh, keyword research, CSV exports) have a tighter separate limit (10 per minute and 300 per day per user). Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Login is limited to 20 requests per minute per IP address and locks for 15 minutes after 5 failed attempts on the same account; wrong keys are limited per IP. Your plan limits (projects, keywords, crawls, analyses) also apply through the API and answer 403 with a code.

The API answers with CORS enabled (Access-Control-Allow-Origin: *): security lies in the Bearer key, not in cookies.

GET responses carry an `ETag`: send it back in `If-None-Match` and, if nothing changed, you get `304 Not Modified` with no body. Static lists (locations, languages) and the OpenAPI spec can be cached for an hour.

Keys can have scopes: `read` (GET only), `write` (also writes) and `admin` (also key rotation). Keys issued before this change have full access. Without the required scope you get 403 `insufficient_scope`.

Every error carries `title`, `status` (a string) and a stable `code`, plus `id` (the same as `X-Request-Id`: quote it when contacting support). A plan without API access answers 403 `plan_no_api` on `/api/v1` (401 on the legacy paths).

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

Webhooks

There are no webhooks: to know whether a job is done, read the resource (see above). Alerts (position drops, regressions) can be read with GET /alerts.

Explanations of scores and metrics

Every score and metric has a plain-language text explaining what it measures, why it matters and how to improve it. It is static, public content: GET /explain lists the entries and GET /explain/{key}?lang=it|en returns the detail. You can use it to show help next to numbers in your own interfaces.

keyDescription
geo_scoreGEO score
avg_page_scoreAverage page score (GEO)
site_penaltiesSite-level penalties (GEO)
ai_crawlersAI crawler access
llms_txtllms.txt file
entity_schemaSite entity (Organization schema)
geo_scoring_versionGEO scoring version
g_scoreG Score
audit_scoreAudit score
spider_scorePage score (Spider)
issue_severityProblem severity
visibility_scoreAI Visibility score
share_of_voiceShare of Voice
citation_positionCitation position
position_bucketsPosition buckets
gained_lostGained and lost keywords
avg_positionAverage position
search_volumeSearch volume
impressionsImpressions
clicksClicks
ctrCTR (click-through rate)
ttfbTime to first byte (TTFB)
link_graphLink graph

Operation reference

Auth

Accesso e credenziali

post /auth/login Login: restituisce la chiave API Public · 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.

Parameters

NameWhereTypeDescription
email required body string Email dell'account.
password required body string Password.
twofa_token optional body string Codice a 6 cifre della 2FA, se attiva.
device_name optional body string Nome del dispositivo (etichetta della chiave).

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

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

Example response

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

Code samples

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 API key · 200

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

Example response

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

Code samples

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 API key · 200

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

Example response

{
    "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"
        ]
    }
}

Code samples

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 API key · 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.

Example response

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

Code samples

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à) API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
q optional query string Testo da cercare. · ita

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 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.

Parameters

NameWhereTypeDescription
name required body string Nome del progetto.
domain required body string Dominio da monitorare.
location_code optional body integer Codice location (predefinito 2380, Italia).
language_code optional body string Codice lingua (predefinito it).

Request body (JSON)

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

Example response

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

Code samples

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 API key · 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).

Parameters

NameWhereTypeDescription
id required path integer Id del progetto. · 11
format optional query string Con csv esporta le keyword del progetto. · csv

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id del progetto. · 11
name optional body string Nuovo nome.
domain optional body string Nuovo dominio.
location_code optional body integer Codice location.
language_code optional body string Codice lingua.
gsc_property optional body string Proprietà Search Console.
ga4_property optional body string Id proprietà GA4 (solo cifre).

Request body (JSON)

{
    "name": "LUM illuminazione"
}

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id del progetto. · 11

Example response

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

Code samples

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 API key · 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.

Parameters

NameWhereTypeDescription
id required path integer Id del progetto. · 11
keywords optional body array Elenco di keyword (alternativa a keyword).
keyword optional body string Una sola keyword.
mode optional body string add (predefinito) o replace.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 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.

Parameters

NameWhereTypeDescription
id required path integer Id del progetto. · 11
Idempotency-Key optional 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.

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
ids required body array Id delle keyword da eliminare.

Request body (JSON)

{
    "ids": [
        301,
        302
    ]
}

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id della keyword. · 301

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id della keyword. · 301
target_url optional body string URL che vorresti posizionare.
tags optional body string Etichette.
notes optional body string Note libere.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

Elimina la keyword e il suo storico.

Parameters

NameWhereTypeDescription
id required path integer Id della keyword. · 301

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id della keyword. · 301
days optional query integer Giorni di storico (massimo 365). · 90

Example response

{
    "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"
            }
        ]
    }
}

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 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.

Parameters

NameWhereTypeDescription
Idempotency-Key optional 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 required body string URL di partenza (anche url).
name optional body string Nome della scansione.
max_pages optional body integer Pagine massime (predefinito 200).
max_depth optional body integer Profondità massima (predefinito 10).
speed optional body string Velocità: safe (predefinito) o più alta se il piano lo consente.
include_subdomains optional body boolean Segue anche i sottodomini.
respect_robots optional body boolean Rispetta robots.txt.
use_sitemap optional body boolean Usa anche la sitemap.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id della scansione. · 94

Example response

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

Code samples

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 API key · 200

Cambia il nome della scansione.

Parameters

NameWhereTypeDescription
id required path integer Id della scansione. · 94
name required body string Nuovo nome.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id della scansione. · 94

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id della scansione. · 94

Example response

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

Code samples

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 API key · 202

Mette in coda una nuova scansione con le stesse impostazioni.

Parameters

NameWhereTypeDescription
id required path integer Id della scansione. · 94
Idempotency-Key optional 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.

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id della scansione. · 94

Example response

{
    "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"
        }
    ]
}

Code samples

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 API key · 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.

Parameters

NameWhereTypeDescription
id required path integer Id della scansione di partenza. · 94
to required query integer Id della scansione con cui confrontare. · 95

Example response

{
    "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
                }
            }
        ]
    }
}

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 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.

Parameters

NameWhereTypeDescription
Idempotency-Key optional 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 required body string Dominio o URL da analizzare (anche host/url).

Request body (JSON)

{
    "domain": "lum.it"
}

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id dell'audit. · 7

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 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.

Parameters

NameWhereTypeDescription
Idempotency-Key optional 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 required body string Nome del brand.
domain optional body string Dominio del brand.
prompts optional body array Domande da testare.
topic optional body string Argomento per generare i prompt.
engine optional body string Motore (predefinito openai).

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id della misurazione. · 3

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 202

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

Parameters

NameWhereTypeDescription
Idempotency-Key optional 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 required body string Pagina da valutare.
keyword optional body string Argomento principale.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id del test. · 2

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 201

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

Parameters

NameWhereTypeDescription
brand required body string Il tuo brand.
competitors required body string Concorrenti, separati da virgola.
mode optional body string single (predefinito) o symmetric_matrix.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

Il report con i risultati per ogni concorrente.

Parameters

NameWhereTypeDescription
id required path integer Id del report. · 1

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 201

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

Parameters

NameWhereTypeDescription
prompt required body string La domanda da analizzare.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

La ricerca con parole chiave e intenti estratti.

Parameters

NameWhereTypeDescription
id required path integer Id della ricerca. · 1

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
keyword optional body string Una keyword.
keywords optional body array Elenco di keyword (analisi in blocco).
location_code optional body integer Codice location.
language_code optional body string Codice lingua.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id del sito. · 5

Example response

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

Code samples

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à) API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id del sito. · 5
sitemap_url optional body string Sitemap.
notifications optional body array Id dei gestori di notifica.
audit_check_interval optional body integer Intervallo di controllo in secondi (0 = mai).

Request body (JSON)

{
    "audit_check_interval": 86400
}

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Request body (JSON)

{
    "notifications_mode": "changes"
}

Example response

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

Code samples

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 API key · 200

Elimina il sito con le sue pagine e lo storico.

Parameters

NameWhereTypeDescription
id required path integer Id del sito. · 5

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 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).

Parameters

NameWhereTypeDescription
Idempotency-Key optional 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 optional body string single (predefinito), bulk o sitemap.
url optional body string URL da analizzare (type single).
urls optional body string Elenco di URL, uno per riga (bulk) o URL della sitemap.
domain_id optional body integer Dominio collegato.
audit_check_interval optional body integer Ripeti ogni N secondi.
notifications optional body array Id dei gestori di notifica.
is_public optional body boolean Pagina pubblica.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id dell'analisi. · 9

Example response

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

Code samples

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à) API key · 200

Identico a PATCH /audits/{id}.

Parameters

NameWhereTypeDescription
id required path integer Id dell'analisi. · 9
audit_check_interval optional body integer

Request body (JSON)

{
    "audit_check_interval": 604800
}

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id dell'analisi. · 9
domain_id optional body integer Dominio collegato.
is_public optional body boolean Pagina pubblica.
password optional body string Password.
audit_check_interval optional body integer Intervallo in secondi.
notifications optional body array Gestori di notifica.
notifications_mode optional body string always o changes.

Request body (JSON)

{
    "audit_check_interval": 604800
}

Example response

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

Code samples

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 API key · 200

Elimina l'analisi e il suo storico.

Parameters

NameWhereTypeDescription
id required path integer Id dell'analisi. · 9

Example response

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

Code samples

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 API key · 200

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

Parameters

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
id required path integer Id dell'analisi archiviata. · 31

Example response

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

Code samples

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 API key · 200

Elimina una versione dallo storico.

Parameters

NameWhereTypeDescription
id required path integer Id dell'analisi archiviata. · 31

Example response

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

Code samples

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

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

Google

Search Console e Analytics dal vivo

get /search-console Search Console: ricerche e pagine API key · 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.

Parameters

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

Example response

{
    "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": []
    }
}

Code samples

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 API key · 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.

Example response

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

Code samples

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 API key · 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).

Parameters

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

Example response

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

Code samples

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 API key · 200

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
is_read optional query integer 0 solo non letti, 1 solo letti. · 0

Example response

{
    "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"
        }
    ]
}

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
is_read optional body boolean Valore da impostare (predefinito vero).

Request body (JSON)

{
    "is_read": true
}

Example response

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

Code samples

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 API key · 200

Imposta lo stato letto/non letto di un avviso.

Parameters

NameWhereTypeDescription
id required path integer Id dell'avviso. · 20
is_read optional body boolean Valore da impostare (predefinito vero).

Request body (JSON)

{
    "is_read": true
}

Example response

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

Code samples

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) API key · 200

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

Example response

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

Code samples

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 API key · 200

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
token required body string Token FCM.
platform optional body string Piattaforma (predefinito android).
app_version optional body string Versione dell'app.

Request body (JSON)

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

Example response

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

Code samples

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 API key · 200

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

Parameters

NameWhereTypeDescription
token optional query string Token FCM (in alternativa al corpo). · fcm-token-di-esempio
token optional body string Token FCM.

Request body (JSON)

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

Example response

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

Code samples

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) API key · 200

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

Parameters

NameWhereTypeDescription
token required path string Token FCM. · fcm-token-di-esempio

Example response

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

Code samples

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 Public · 200

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

Parameters

NameWhereTypeDescription
lang optional query string it (predefinito) o en. · it

Example response

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

Code samples

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 Public · 200

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

Parameters

NameWhereTypeDescription
key required path string Chiave (es. geo_score). · geo_score
lang optional query string it (predefinito) o en. · it

Example response

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

Code samples

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 Public · 200

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

Example response

{
    "status": "ok"
}

Code samples

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']