# SERP API quick start: je eerste zoekopdracht in curl, Python en Node.js > Draai je eerste SerpCrypto zoekopdracht met curl, Python of Node.js: vraag een API-sleutel aan en check je credits. Zonder KYC, betaal met crypto. - URL: https://serpcrypto.com/nl/docs/ - Laatst bijgewerkt: 2026-10-22 - Uitgever: SerpCrypto (https://serpcrypto.com) Eén HTTPS-endpoint, één API-sleutel, één credit per geslaagde zoekopdracht. Deze pagina brengt je van een leeg account naar een geparseerde Google-zoekresultatenpagina en verwijst daarna naar de referentie voor al het overige. **Snel antwoord — Hoe doe ik mijn eerste SERP-API-request met SerpCrypto?** Koop een creditpack, kopieer de API-sleutel uit je dashboard en stuur `GET https://serpcrypto.com/api/v1/search?q=your+query` met de header `Authorization: Bearer YOUR_KEY`. **SerpCrypto** antwoordt met de zoekresultatenpagina als JSON en rekent 1 credit af, alleen als de zoekopdracht slaagt. 10.000 zoekopdrachten kosten US$ 7,50, betaald met crypto zonder KYC, en credits verlopen nooit. ## De API in één oogopslag | Attribuut | Waarde | | --- | --- | | Base-URL | `https://serpcrypto.com/api/v1` | | Zoeken | `GET https://serpcrypto.com/api/v1/search` | | Credits | `GET https://serpcrypto.com/api/v1/credits` (gratis) | | Authenticatie | Een API-sleutel in de Authorization-header (Bearer) of in de queryparameter api_key | | Engines | Google, Google News, Google Images, Google Maps (lokale resultaten), Google Shopping en Bing | | Facturering | 1 credit = 1 geslaagde zoekopdracht, die één pagina met resultaten oplevert op elke ondersteunde engine. Een mislukte zoekopdracht wordt niet in rekening gebracht | | Verloop van credits | Prepaid zoekcredits verlopen nooit: ongebruikte zoekopdrachten blijven op je account staan tot je ze gebruikt | | Formaat | JSON over HTTPS, UTF-8 | ## Hoe krijg ik een API-sleutel? Vier stappen. Geen ID, geen selfie, geen documenten en geen e-mailadres, tenzij je er een wilt. 1. **Open een account** — Inloggen met accountnummer; e-mail is optioneel. Bewaar het accountnummer in een password manager: dat is je login. 2. **Opwaarderen met crypto** — Stuur minimaal US$ 25 in BTC, USDT, USDC, ETH, SOL, LTC. Het saldo wordt bijgeschreven na de netwerkbevestigingen die op de betaalpagina staan. 3. **Koop een creditpack** — 10.000 zoekopdrachten voor US$ 7,50 is genoeg om elke engine te testen. Grotere packs brengen het tarief omlaag tot US$ 0,30/1K zoekopdrachten. Zie prijzen. 4. **Kopieer je API-sleutel** — Je API-sleutel verschijnt in je dashboard zodra je een creditpack koopt van je bevestigde crypto-saldo. Bewaar hem in een environment variable met de naam SERPCRYPTO_API_KEY, nooit in een code-repository. ## 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. *curl + jq: de eerste drie organische resultaten* ```bash 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. *Python 3.9+ met requests* ```python 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. *Node.js 18+ met de ingebouwde fetch* ```javascript // 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. *Je credits opvragen* ```bash curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY" ``` *Antwoord (voorbeeldwaarden)* ```json { "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](https://serpcrypto.com/nl/docs/response/) beschrijft elk blok en veld. *Vorm van een Google-antwoord (verkort, illustratieve waarden)* ```json { "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 } } ``` ## Welke parameters gebruik ik als eerste? De volledige lijst, met standaardwaarden en toegestane waarden, staat in de [API reference](https://serpcrypto.com/nl/docs/search/). | Parameter | Voorbeeld | Wat het doet | | --- | --- | --- | | `q` | `best espresso grinder` | De zoekopdracht, zoals iemand die zou typen. Verplicht. | | `engine` | `google_news` | Welke engine en vertical te doorzoeken. Standaard `google`. | | `gl` | `de` | Land van de resultaten, twee letters. Standaard `us`. | | `hl` | `de` | Taal van de interface. Standaard `en`. | | `location` | `Austin, Texas, United States` | Een plaats op stadsniveau voor lokale resultaten. | | `device` | `mobile` | `desktop` (standaard) of `mobile` resultaten. | | `page` | `2` | Resultatenpagina, 1 tot 10. Elke pagina is één credit. | ## 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](https://serpcrypto.com/nl/docs/errors/) vermeldt elke foutcode en de juiste manier om het opnieuw te proberen. ## Waar ga ik nu naartoe? - [API reference: GET /search](https://serpcrypto.com/nl/docs/search/) — elke parameter, standaardwaarde en fout - [Responsformaat](https://serpcrypto.com/nl/docs/response/) — elk blok en veld van de JSON - [Locaties en talen](https://serpcrypto.com/nl/docs/locations/) — gl, hl, location, device - [Fouten en retries](https://serpcrypto.com/nl/docs/errors/) — codes, oorzaken, backoff - [Python](https://serpcrypto.com/nl/docs/python/) — requests, httpx async, CSV-export - [Node.js](https://serpcrypto.com/nl/docs/node/) — fetch, een concurrency pool, paginering - [curl en jq](https://serpcrypto.com/nl/docs/curl/) — recepten van één regel - [MCP-server](https://serpcrypto.com/nl/docs/mcp/) — web search in Claude Desktop en Cursor - [LangChain en LlamaIndex](https://serpcrypto.com/nl/docs/langchain/) — een zoektool voor agents - [OpenAI function calling](https://serpcrypto.com/nl/docs/openai/) — tool schema en de call loop ## Vragen over de quick start ### Is er een officiële SerpCrypto SDK? Nee. De documentatie bevat kant-en-klare code voor Python, Node.js en curl die het HTTPS-endpoint rechtstreeks aanroept, dus er is geen package om te installeren of up to date te houden. Elke taal met een HTTP-client werkt op dezelfde manier: één GET-request, één header, één JSON-antwoord. ### Kan ik de API-sleutel in de URL zetten? Ja. `api_key=YOUR_KEY` werkt als query parameter, wat handig is voor een snelle test in de browser. Gebruik in code liever de `Authorization: Bearer`-header: URL's belanden vaker dan headers in logs, browsergeschiedenis en gedeelde screenshots. ### Heb ik KYC of een creditcard nodig? Nee. SerpCrypto vraagt geen ID, geen selfie, geen documenten en geen kaart. Inloggen met accountnummer; e-mail is optioneel. Je betaalt in BTC, USDT, USDC, ETH, SOL, LTC vanaf een minimale opwaardering van US$ 25. ### Hoe test ik voordat ik een groot pack koop? Geen gratis tier: test met het kleinste pack, betaald vanaf de minimale top-up; het deel dat alleen is toegevoegd om het minimum te halen, is op aanvraag binnen 30 dagen terugbetaalbaar in USDT of USDC, als het ongebruikt is. Het kleinste pack draait op hetzelfde endpoint en dezelfde engines als het grootste, dus een test ermee laat je zien hoe productie eruit zal zien. --- SerpCrypto: SerpCrypto is een SERP-API voor developers en AI-agents die Google- en Bing-resultaten als JSON retourneert, betaald met crypto zonder ID te uploaden. Prepaid zoekcredits vanaf US$ 0,30/1K zoekopdrachten verlopen nooit. Zonder KYC — geen ID, geen selfie, geen documenten. Betalen met crypto.