Google Search API

L'API Google Search ti consente di effettuare ricerche web e ricevere risultati strutturati. Supporta più tipi di ricerca, targeting geografico, emulazione di dispositivi e due modalità di profondità dei risultati.

Endpoint

Bash

POST https://api.scavio.dev/api/v1/google

Intestazioni

Intestazione	Valore	Obbligatorio
`Authorization`	`Bearer YOUR_API_KEY`	Sì
`Content-Type`	`application/json`	Sì

Corpo della richiesta

Parametro	Tipo	Predefinito	Descrizione
`query`	`string`	--	Obbligatorio. La query di ricerca (1-500 caratteri).
`search_type`	`string`	`classic`	Uno tra: `classic`, `news`, `maps`, `images`, `lens`
`country_code`	`string`	--	Codice paese ISO 3166-1 alfa-2 (es. `us`, `gb`, `de`). Vedi l'elenco completo.
`language`	`string`	--	Codice lingua ISO 639-1 (es. `en`, `fr`, `es`)
`page`	`number`	`1`	Numero di pagina dei risultati (a partire da 1)
`device`	`string`	`desktop`	`desktop` o `mobile`. La ricerca news supporta solo `desktop`.
`nfpr`	`boolean`	`false`	Imposta a `true` per disabilitare la correzione automatica della query
`light_request`	`boolean`	omesso (light)	Ometti per modalità light (1 credito). Imposta a `false` per risultati completi (2 crediti) inclusi grafo della conoscenza, ricerche correlate e altro.

Costo in crediti

Scenario	Crediti
`light_request` omesso o non inviato	1
`"light_request": false`	2

Esempio minimo

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "Scavio search API"}'

Esempio completo (con tutti i parametri)

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "AI startups funding",
    "search_type": "news",
    "country_code": "us",
    "language": "en",
    "page": 1,
    "device": "desktop",
    "nfpr": false,
    "light_request": false
  }'

Vincoli

Quando search_type è news, solo desktop è consentito come device. L'invio di mobile restituirà un errore 400.
Valori search_type non validi (es. shopping, ai_mode) restituiranno un errore di validazione 400.
device accetta solo desktop o mobile. tablet non è supportato.

Formato della risposta

Tutte le risposte con successo restituiscono un oggetto JSON. Alcuni campi sono sempre presenti, mentre altri appaiono solo quando non vuoti (tipicamente in modalità full).

Campi principali (sempre presenti)

Campo	Tipo	Descrizione
`results`	`array`	Array di oggetti risultati di ricerca organici
`results[].title`	`string`	Titolo della pagina del risultato di ricerca
`results[].url`	`string`	URL completo del risultato
`results[].content`	`string`	Snippet o meta description della pagina
`results[].position`	`number`	Posizione nei risultati (a partire da 1)
`query`	`string`	La query eseguita
`page`	`number`	Il numero di pagina restituito
`country_code`	`string`	Codice paese utilizzato per la ricerca
`language`	`string`	Codice lingua utilizzato per la ricerca
`response_time`	`number`	Tempo di risposta lato server in millisecondi
`credits_used`	`number`	Numero di crediti consumati (1 o 2)
`credits_remaining`	`number`	Crediti rimanenti nel tuo periodo di fatturazione corrente

Campi opzionali (presenti quando non vuoti)

Questi sono tipicamente restituiti in modalità full ("light_request": false) ma possono apparire anche in modalità light quando i dati sono disponibili.

Campo	Tipo	Descrizione
`top_stories`	`array`	Elementi del carosello delle notizie principali
`news_results`	`array`	Articoli di notizie con `title`, `link`, `source`, `snippet`, `date`, `relative_date`, `domain`, `position`
`knowledge_graph`	`object`	Pannello della conoscenza con `title`, `subtitle`, e array `factoids`
`questions`	`array`	"Le persone chiedono anche" con `question` e `answer`
`related_searches`	`array`	Query correlate, ciascuna con `query`, `link`, `type`, `position`
`total_results`	`number`	Numero totale stimato di risultati per la query
`search_url`	`string`	URL originale del motore di ricerca per questa query

Esempio di risposta in modalità light

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform. Structured JSON results.",
      "position": 1,
      "displayed_url": "https://scavio.dev",
      "domain": "scavio.dev",
      "date": null,
      "rich_snippet": {},
      "sitelinks": []
    }
  ],
  "query": "Scavio search API",
  "page": 1,
  "country_code": "us",
  "language": "en",
  "response_time": 450,
  "credits_used": 1,
  "credits_remaining": 999
}

Esempio di risposta in modalità full

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform. Structured JSON results.",
      "position": 1,
      "displayed_url": "https://scavio.dev",
      "domain": "scavio.dev",
      "date": null,
      "rich_snippet": {},
      "sitelinks": []
    }
  ],
  "query": "Scavio search API",
  "page": 1,
  "country_code": "us",
  "language": "en",
  "response_time": 620,
  "total_results": 1250000,
  "search_url": "https://www.google.com/search?q=...",
  "knowledge_graph": {
    "title": "Scavio",
    "subtitle": "Search API Platform",
    "factoids": [
      { "title": "Type", "content": "Developer API" }
    ]
  },
  "related_searches": [
    { "query": "scavio api pricing", "link": null, "type": null, "position": 0 },
    { "query": "scavio search api docs", "link": null, "type": null, "position": 1 }
  ],
  "questions": [
    {
      "question": "What is Scavio?",
      "answer": "Scavio is a multi-platform search API..."
    }
  ],
  "credits_used": 2,
  "credits_remaining": 998
}

Esempio di risultati news

Quando search_type è news, il campo news_results viene popolato:

JSON

{
  "news_results": [
    {
      "title": "AI Startups Raise Record Funding in Q1 2026",
      "link": "https://example.com/ai-funding",
      "source": "TechCrunch",
      "snippet": "AI companies raised over $15B in Q1 2026...",
      "date": "2026-03-31T20:00:00.000Z",
      "relative_date": "2 hours ago",
      "domain": "techcrunch.com",
      "position": 1
    }
  ]
}

Note

L'array results è ordinato per rilevanza (la posizione 1 è la più rilevante)
I campi opzionali sono presenti solo quando non vuoti -- verifica sempre la loro esistenza prima di accedervi
La modalità light (1 credito) restituisce i risultati principali. La modalità full (2 crediti) può includere tutti i campi opzionali.

Correlati

YouTube API -- ricerca e metadati
Amazon API -- ricerca prodotti e dettagli
Codici paese -- codici paese supportati
Errori -- codici di errore e gestione

Google Search API

Endpoint

Bash

POST https://api.scavio.dev/api/v1/google

Intestazioni

Intestazione	Valore	Obbligatorio
`Authorization`	`Bearer YOUR_API_KEY`	Sì
`Content-Type`	`application/json`	Sì

Corpo della richiesta

Parametro	Tipo	Predefinito	Descrizione
`query`	`string`	--	Obbligatorio. La query di ricerca (1-500 caratteri).
`search_type`	`string`	`classic`	Uno tra: `classic`, `news`, `maps`, `images`, `lens`
`country_code`	`string`	--	Codice paese ISO 3166-1 alfa-2 (es. `us`, `gb`, `de`). Vedi l'elenco completo.
`language`	`string`	--	Codice lingua ISO 639-1 (es. `en`, `fr`, `es`)
`page`	`number`	`1`	Numero di pagina dei risultati (a partire da 1)
`device`	`string`	`desktop`	`desktop` o `mobile`. La ricerca news supporta solo `desktop`.
`nfpr`	`boolean`	`false`	Imposta a `true` per disabilitare la correzione automatica della query
`light_request`	`boolean`	omesso (light)	Ometti per modalità light (1 credito). Imposta a `false` per risultati completi (2 crediti) inclusi grafo della conoscenza, ricerche correlate e altro.

Costo in crediti

Scenario	Crediti
`light_request` omesso o non inviato	1
`"light_request": false`	2

Esempio minimo

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "Scavio search API"}'

Esempio completo (con tutti i parametri)

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "AI startups funding",
    "search_type": "news",
    "country_code": "us",
    "language": "en",
    "page": 1,
    "device": "desktop",
    "nfpr": false,
    "light_request": false
  }'

Vincoli

Quando search_type è news, solo desktop è consentito come device. L'invio di mobile restituirà un errore 400.
Valori search_type non validi (es. shopping, ai_mode) restituiranno un errore di validazione 400.
device accetta solo desktop o mobile. tablet non è supportato.

Formato della risposta

Tutte le risposte con successo restituiscono un oggetto JSON. Alcuni campi sono sempre presenti, mentre altri appaiono solo quando non vuoti (tipicamente in modalità full).

Campi principali (sempre presenti)

Campo	Tipo	Descrizione
`results`	`array`	Array di oggetti risultati di ricerca organici
`results[].title`	`string`	Titolo della pagina del risultato di ricerca
`results[].url`	`string`	URL completo del risultato
`results[].content`	`string`	Snippet o meta description della pagina
`results[].position`	`number`	Posizione nei risultati (a partire da 1)
`query`	`string`	La query eseguita
`page`	`number`	Il numero di pagina restituito
`country_code`	`string`	Codice paese utilizzato per la ricerca
`language`	`string`	Codice lingua utilizzato per la ricerca
`response_time`	`number`	Tempo di risposta lato server in millisecondi
`credits_used`	`number`	Numero di crediti consumati (1 o 2)
`credits_remaining`	`number`	Crediti rimanenti nel tuo periodo di fatturazione corrente

Campi opzionali (presenti quando non vuoti)

Questi sono tipicamente restituiti in modalità full ("light_request": false) ma possono apparire anche in modalità light quando i dati sono disponibili.

Campo	Tipo	Descrizione
`top_stories`	`array`	Elementi del carosello delle notizie principali
`news_results`	`array`	Articoli di notizie con `title`, `link`, `source`, `snippet`, `date`, `relative_date`, `domain`, `position`
`knowledge_graph`	`object`	Pannello della conoscenza con `title`, `subtitle`, e array `factoids`
`questions`	`array`	"Le persone chiedono anche" con `question` e `answer`
`related_searches`	`array`	Query correlate, ciascuna con `query`, `link`, `type`, `position`
`total_results`	`number`	Numero totale stimato di risultati per la query
`search_url`	`string`	URL originale del motore di ricerca per questa query

Esempio di risposta in modalità light

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform. Structured JSON results.",
      "position": 1,
      "displayed_url": "https://scavio.dev",
      "domain": "scavio.dev",
      "date": null,
      "rich_snippet": {},
      "sitelinks": []
    }
  ],
  "query": "Scavio search API",
  "page": 1,
  "country_code": "us",
  "language": "en",
  "response_time": 450,
  "credits_used": 1,
  "credits_remaining": 999
}

Esempio di risposta in modalità full

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform. Structured JSON results.",
      "position": 1,
      "displayed_url": "https://scavio.dev",
      "domain": "scavio.dev",
      "date": null,
      "rich_snippet": {},
      "sitelinks": []
    }
  ],
  "query": "Scavio search API",
  "page": 1,
  "country_code": "us",
  "language": "en",
  "response_time": 620,
  "total_results": 1250000,
  "search_url": "https://www.google.com/search?q=...",
  "knowledge_graph": {
    "title": "Scavio",
    "subtitle": "Search API Platform",
    "factoids": [
      { "title": "Type", "content": "Developer API" }
    ]
  },
  "related_searches": [
    { "query": "scavio api pricing", "link": null, "type": null, "position": 0 },
    { "query": "scavio search api docs", "link": null, "type": null, "position": 1 }
  ],
  "questions": [
    {
      "question": "What is Scavio?",
      "answer": "Scavio is a multi-platform search API..."
    }
  ],
  "credits_used": 2,
  "credits_remaining": 998
}

Esempio di risultati news

Quando search_type è news, il campo news_results viene popolato:

JSON

{
  "news_results": [
    {
      "title": "AI Startups Raise Record Funding in Q1 2026",
      "link": "https://example.com/ai-funding",
      "source": "TechCrunch",
      "snippet": "AI companies raised over $15B in Q1 2026...",
      "date": "2026-03-31T20:00:00.000Z",
      "relative_date": "2 hours ago",
      "domain": "techcrunch.com",
      "position": 1
    }
  ]
}

Note

L'array results è ordinato per rilevanza (la posizione 1 è la più rilevante)
I campi opzionali sono presenti solo quando non vuoti -- verifica sempre la loro esistenza prima di accedervi
La modalità light (1 credito) restituisce i risultati principali. La modalità full (2 crediti) può includere tutti i campi opzionali.

Correlati

YouTube API -- ricerca e metadati
Amazon API -- ricerca prodotti e dettagli
Codici paese -- codici paese supportati
Errori -- codici di errore e gestione