Quickstart

serp.cheap zet een Google-zoekopdracht om in schone JSON via één enkel HTTPS-endpoint.

• Base-URL: https://api.serp.cheap
• Endpoint: POST /v1/search
• Auth: een x-api-key-header

1. Haal een API-sleutel op

Meld je aan op app.serp.cheap en maak een sleutel aan. Elk nieuw account begint met gratis credits.

2. Stuur een verzoek

Stuur je query als JSON met je sleutel in de x-api-key-header.

curl

curl -X POST https://api.serp.cheap/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "q": "best running shoes", "gl": "us" }'

JavaScript

import { SerpCheap } from "@serpcheap/sdk";

const client = new SerpCheap("YOUR_API_KEY");
const res = await client.search({ q: "best running shoes", gl: "us" });
console.log(res.organic[0].title);

Python

from serpcheap import SerpCheap

client = SerpCheap("YOUR_API_KEY")
res = client.search(q="best running shoes", gl="us")
print(res.organic[0].title)

3. Lees de respons

Resultaten komen gerangschikt terug, met een optionele Knowledge Graph en factureringsstatistieken.

{
  "search": "best running shoes",
  "page": 1,
  "organic": [
    {
      "position": 1,
      "title": "The 10 Best Running Shoes of 2026",
      "link": "https://example.com/best-running-shoes",
      "snippet": "Our running experts tested 40+ pairs…"
    }
  ],
  "knowledgeGraph": { "title": "Running shoe", "description": "…" },
  "stats": { "balance": 9994, "cost": 6, "cached": false }
}

Eén zoekopdracht = één verse fetch

Een verse fetch kost 6 credits; een cache-treffer kost 3. stats.cost vertelt je precies wat elke aanroep heeft gekost en stats.balance is je resterende saldo. Zie Prijzen & credits.

Volgende stappen

• Authenticatie — sleutels, headers en de auth-fouten.
• Zoekparameters — land, taal, tijdfilters, paginering.
• Responsstructuur — organic, ads, Knowledge Graph, gerelateerde zoekopdrachten.
• SDK’s — officiële bibliotheken voor JS, Python, Go, Rust en Java.