# API documentation

> BestSERP API reference: authentication, endpoints for web, images, news, videos, shopping, places and maps, async polling, credits, rate limits and errors.

Source: https://bestserp.com/docs (updated 2026-11-14)

BestSERP returns Google results pages as JSON. One HTTPS request per search, 7 result types, one response format.

Base URL: `https://api.bestserp.com`

## Endpoints

| Method | Path | Returns |
| --- | --- | --- |
| POST, GET | [`/search`](https://bestserp.com/docs/api/search) | Organic Google results, plus the video carousel (videos) and Top stories (news) when the page has them. |
| POST, GET | [`/images`](https://bestserp.com/docs/api/images) | Google Images results with full-size image URLs and dimensions. |
| POST, GET | [`/news`](https://bestserp.com/docs/api/news) | The Google News tab, with source, publish time and site icon. |
| POST, GET | [`/videos`](https://bestserp.com/docs/api/videos) | The Google Videos tab, with duration, channel and platform. |
| POST, GET | [`/shopping`](https://bestserp.com/docs/api/shopping) | Google Shopping products with price, discount, delivery and rating. |
| POST, GET | [`/places`](https://bestserp.com/docs/api/places) | Local results (the Places tab): rating, address, category and opening hours. |
| POST, GET | [`/maps`](https://bestserp.com/docs/api/maps) | Google Maps places with coordinates, place id and CID. |
| GET | [`/requests/{requestId}`](https://bestserp.com/docs/async) | A request answered 202, once it is ready |
| GET | [`/account`](https://bestserp.com/docs/account) | Your credit balance |

## Start here

1. [Quickstart](https://bestserp.com/docs/quickstart): a key and your first request in two minutes.
2. [Authentication](https://bestserp.com/docs/authentication): how to send the key.
3. [Credits](https://bestserp.com/docs/credits), [rate limits](https://bestserp.com/docs/rate-limits) and [errors](https://bestserp.com/docs/errors): what a request costs and what can go wrong.

Moving from Serper? Read [Migrate from Serper](https://bestserp.com/docs/migrate-from-serper).

## Machine-readable

- OpenAPI 3: https://api.bestserp.com/openapi.json
- Postman collection: https://api.bestserp.com/postman.json

Every page of these docs is also available as Markdown: add `.md` to its URL, for example [/docs/quickstart.md](https://bestserp.com/docs/quickstart.md).
