# SerpWiz API documentation

SerpWiz is a real-time search API. Send a `GET` request, get the live results page back as clean JSON. It costs **$0.15 per 1,000 queries** on every plan ($0.11 with a year prepaid), and **only successful requests are charged**.

```bash
curl "https://api.serpwiz.com/v1/google/search?q=best+crm+for+startups" \
  -H "X-API-Key: $SERPWIZ_API_KEY"
```

## Endpoints

| Endpoint | Returns |
|---|---|
| [`GET /v1/google/search`](/docs/google-search) | Google web results: organic results, ads, top stories, knowledge panel, People Also Ask, related searches, pagination |
| [`GET /v1/google/maps`](/docs/google-maps) | Google Maps places: name, address, rating, reviews count, phone, website, coordinates, opening hours and more |
| [`GET /v1/account`](/docs/account) | Your query balance, free allowance, RPS limit and plan (free to call) |

More engines are on the way. Each gets its own endpoint under `/v1/{engine}/{type}`, at the same flat rate.

## How it works

- **Base URL:** `https://api.serpwiz.com/v1`
- **Auth:** an API key in the `X-API-Key` header. [Get one free](/signup) — 1,000 queries a month, no card.
- **One query = one successful request.** No credit multipliers. Failed requests, timeouts and `429`s cost nothing.
- **Rate limits are per account**, in requests per second (RPS). Every $10/mo of plan adds 1 RPS, up to 100 RPS self-serve. See [Rate limits](/docs/rate-limits).
- **Credits roll over** and are valid for 12 months from purchase. See [Credits & billing](/docs/credits).

## Next steps

1. [Quickstart](/docs/quickstart) — your first call in curl, Python, JavaScript or PHP.
2. [Google Search reference](/docs/google-search) — every parameter and response field.
3. [Errors](/docs/errors) — status codes and how to retry.

Building with an LLM? Point it at [`/llms.txt`](https://serpwiz.com/llms.txt), the [OpenAPI spec](https://serpwiz.com/openapi.json), or any docs page with `.md` appended — see [AI agents & LLMs](/docs/ai-agents).