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
- From your account, on the API keys page: you can create a new one, rotate it or revoke it.
- With
POST /auth/login(email and password, plustwofa_tokenif you use 2FA): it returns the key in theapi_keyfield. POST /api-key/rotateissues a new key and revokes the one in use; the key is shown only once, save it right away.DELETE /auth/tokenrevokes it.
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
200 | OK. |
201 | Created (or queued: see "Long operations"). |
401 | Missing or invalid key, inactive account, plan without API. |
403 | Operation not allowed by the plan (limit reached, paid tool). |
404 | The resource does not exist or is not yours. |
409 | Integration not connected (for example Google or DataForSEO). |
422 | Invalid data. |
429 | Too many requests: wait and retry. |
501 | Feature not available on this installation. |
503 | External 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.
POST /auditsanswers 201 withis_queued: true; re-readGET /audits/{id}untilis_queuedbecomesfalse.POST /spiderreturnsscan_id; re-readGET /spider/{id}untilstatusiscompleted.POST /georeturnsaudit_id; re-readGET /geo/{id}.
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_key | Manca l'intestazione Authorization: Bearer. |
invalid_key | Chiave API sconosciuta, scaduta o revocata. |
inactive_account | Account non attivo. |
plan_no_api | Il piano non include l'API (403 su /api/v1, 401 sui percorsi legacy). |
insufficient_scope | La chiave non ha l'ambito richiesto (read, write, admin). |
quota_exceeded | Credito o quota esaurita (es. 402 DataForSEO). |
validation_failed | Dati non validi (422): vedi `fields`. |
throttled | Troppe richieste (429): vedi `Retry-After`. |
not_found | Risorsa inesistente o non tua. |
not_implemented | Azione non disponibile (501). |
idempotency_mismatch | Idempotency-Key gia' usata con un corpo diverso (422). |
idempotency_in_progress | Una richiesta con la stessa Idempotency-Key e' ancora in corso (409). |
idempotency_key_invalid | Idempotency-Key non valida (422). |
payload_too_large | Corpo troppo grande (413). |
twofa_required | Serve il codice a due fattori (login). |
twofa_invalid | Codice a due fattori non valido (login). |
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.
| key | Description |
|---|---|
geo_score | GEO score |
avg_page_score | Average page score (GEO) |
site_penalties | Site-level penalties (GEO) |
ai_crawlers | AI crawler access |
llms_txt | llms.txt file |
entity_schema | Site entity (Organization schema) |
geo_scoring_version | GEO scoring version |
g_score | G Score |
audit_score | Audit score |
spider_score | Page score (Spider) |
issue_severity | Problem severity |
visibility_score | AI Visibility score |
share_of_voice | Share of Voice |
citation_position | Citation position |
position_buckets | Position buckets |
gained_lost | Gained and lost keywords |
avg_position | Average position |
search_volume | Search volume |
impressions | Impressions |
clicks | Clicks |
ctr | CTR (click-through rate) |
ttfb | Time to first byte (TTFB) |
link_graph | Link 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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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']
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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
| Name | Where | Type | Description |
|---|---|---|---|
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']
No operation matches the search.
