SERP API quick start: je eerste zoekopdracht in curl, Python en Node.js

Hoe draai ik mijn eerste zoekopdracht met curl?

Exporteer de API-sleutel één keer en stuur dan één GET-request. De -G-flag met --data-urlencode bouwt de query string en encodeert spaties en accenten voor je. Het antwoord is één JSON-document, en jq houdt het leesbaar in een terminal.

Het voorbeeld vraagt Google, de standaard-engine, om Amerikaanse resultaten in het Engels. Wijzig q, gl of hl en draai het opnieuw: elke geslaagde run gebruikt één credit.

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

Hoe draai ik dezelfde zoekopdracht in Python?

Gebruik elke HTTP-client. Met requests geef je de parameters door als dictionary en de API-sleutel in de header. raise_for_status() verandert een foutantwoord, zoals 401 bij een verkeerde API-sleutel, in een exception die je kunt opvangen.

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"])

En in Node.js?

Node.js 18 en later leveren fetch mee, dus je hebt geen package nodig. Sla het bestand op met de .mjs-extensie om await op topniveau te gebruiken en voer dan node first-search.mjs uit.

// 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);
}

Hoe controleer ik hoeveel credits ik nog over heb?

Roep GET https://serpcrypto.com/api/v1/credits aan met dezelfde sleutel. Het is gratis en geeft drie getallen terug: resterende credits, vandaag gebruikte credits en hoeveel zoekopdrachten je account tegelijk mag uitvoeren. Elk account kan een vast aantal zoekopdrachten tegelijk uitvoeren; de limiet staat in je dashboard en wordt op aanvraag verhoogd.

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

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

Wat krijg ik terug van een zoekopdracht?

Elk antwoord heeft hetzelfde kader op alle engines. search_metadata zegt of de zoekopdracht is geslaagd en hoeveel credits hij heeft gebruikt. search_parameters herhaalt de toegepaste instellingen, inclusief de standaardwaarden. Daarna volgt per blok van de resultatenpagina een array of object, zoals organic_results of people_also_ask.

Een blok is er alleen als de pagina het toont, dus lees het met een standaardwaarde. De pagina response format beschrijft elk blok en veld.

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

Wat kost een zoekopdracht, en wanneer is die gratis?

1 credit = 1 geslaagde zoekopdracht, die één pagina met resultaten oplevert op elke ondersteunde engine. Een mislukte zoekopdracht wordt niet in rekening gebracht. Ongeveer 10 organische resultaten per pagina, zoals Google levert sinds het in september 2025 stopte met num=100; elke extra pagina kost nog een credit. Een verzoek dat wordt afgewezen door een ongeldige parameter, een verkeerde sleutel, een leeg saldo of een bezet account is ook gratis, en dat geldt ook voor elke call naar het credits-endpoint.

De prijzen lopen van US$ 7,50 voor 10.000 zoekopdrachten tot US$ 0,30/1K zoekopdrachten bij het grootste pack, per oktober 2026. Prepaid zoekcredits verlopen nooit: ongebruikte zoekopdrachten blijven op je account staan tot je ze gebruikt. De errors page vermeldt elke foutcode en de juiste manier om het opnieuw te proberen.