SERP API quick start: la tua prima ricerca in curl, Python e Node.js

Come eseguo la mia prima ricerca con curl?

Esporta la chiave una volta, poi invia una richiesta GET. Il flag -G con --data-urlencode costruisce la query string e codifica spazi e accenti per te. La risposta è un singolo documento JSON e jq lo mantiene leggibile in un terminale.

L'esempio interroga Google, il motore predefinito, per risultati USA in inglese. Cambia q, gl o hl ed eseguilo di nuovo: ogni esecuzione riuscita usa un credito.

export SERPCRYPTO_API_KEY="paste-your-key-here"

curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=best espresso grinder" \
  -d gl=us -d hl=en | jq '.organic_results[:3]'

Come eseguo la stessa ricerca in Python?

Usa un qualsiasi client HTTP. Con requests, passa i parametri come dizionario e la chiave nell'header. raise_for_status() trasforma una risposta di errore, come 401 per una chiave sbagliata, in un'eccezione che puoi intercettare.

import os

import requests

API_URL = "https://serpcrypto.com/api/v1/search"
API_KEY = os.environ["SERPCRYPTO_API_KEY"]

response = requests.get(
    API_URL,
    params={"q": "best espresso grinder", "gl": "us", "hl": "en"},
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=60,
)
response.raise_for_status()
data = response.json()

print("credits used:", data["search_metadata"]["credits_used"])
for result in data.get("organic_results", [])[:3]:
    print(result["position"], result["title"], result["link"])

E in Node.js?

Node.js 18 e versioni successive includono fetch, quindi non serve alcun pacchetto. Salva il file con l'estensione .mjs per usare await al livello superiore, poi esegui node first-search.mjs.

// first-search.mjs (Node.js 18 or later: fetch and top-level await are built in)
const API_URL = "https://serpcrypto.com/api/v1/search";
const params = new URLSearchParams({ q: "best espresso grinder", gl: "us", hl: "en" });

const response = await fetch(`${API_URL}?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPCRYPTO_API_KEY}` },
});
if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
const data = await response.json();

console.log("credits used:", data.search_metadata.credits_used);
for (const result of (data.organic_results ?? []).slice(0, 3)) {
  console.log(result.position, result.title, result.link);
}

Come faccio a controllare quanti crediti mi restano?

Chiama GET https://serpcrypto.com/api/v1/credits con la stessa chiave. È gratis e restituisce tre numeri: crediti rimasti, crediti usati oggi e quante ricerche può eseguire contemporaneamente il tuo account. Ogni account può eseguire un numero fisso di ricerche contemporaneamente; il limite è indicato nella tua dashboard e viene aumentato su richiesta.

curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY"

{
  "credits_remaining": 84210,
  "credits_used_today": 1290,
  "concurrency_limit": 10
}

Cosa restituisce una ricerca?

Ogni risposta ha la stessa struttura su tutti i motori. search_metadata indica se la ricerca è andata a buon fine e quanti crediti ha usato. search_parameters ripete le impostazioni applicate, compresi i valori predefiniti. Poi c'è un array o un oggetto per ogni blocco della pagina dei risultati, come organic_results o people_also_ask.

Un blocco è presente solo quando la pagina lo mostra, quindi leggilo con un valore predefinito. La pagina formato della risposta descrive ogni blocco e ogni campo.

{
  "search_metadata": { "id": "srch_7f3a9c2e41b8", "status": "success", "engine": "google", "credits_used": 1 },
  "search_parameters": { "engine": "google", "q": "best espresso grinder", "gl": "us", "hl": "en", "page": 1 },
  "search_information": { "total_results": 18600000, "query_displayed": "best espresso grinder" },
  "organic_results": [ { "position": 1, "title": "…", "link": "https://www.example.com/…", "snippet": "…" } ],
  "people_also_ask": [ { "question": "…", "snippet": "…", "link": "https://www.example.org/…" } ],
  "related_searches": [ { "query": "best espresso grinder under 300" } ],
  "pagination": { "current": 1, "next_page": 2 }
}

Quanto costa una ricerca e quando è gratis?

1 credito = 1 richiesta di ricerca andata a buon fine, che restituisce una pagina di risultati su qualsiasi motore supportato. Una richiesta non riuscita non viene addebitata. Circa 10 risultati organici per pagina, come Google serve da quando ha smesso di rispettare num=100 a settembre 2025; ogni pagina in più costa un altro credito. Anche una richiesta rifiutata per un parametro errato, una chiave sbagliata, un saldo vuoto o un account occupato è gratis, e lo è pure ogni chiamata all'endpoint dei crediti.

I prezzi vanno da 7,50 USD per 10.000 ricerche a 0,30 USD/1K ricerche sul pack più grande, a ottobre 2026. I crediti di ricerca prepagati non scadono mai: le ricerche non utilizzate restano sul tuo account finché non le usi. La pagina degli errori elenca ogni codice di errore e il modo giusto per riprovare.