API documentation
BestSERP API reference: authentication, endpoints for web, images, news, videos, shopping, places and maps, async polling, credits, rate limits and errors.
Updated View as Markdown
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` | Organic Google results, plus the video carousel (videos) and Top stories (news) when the page has them. |
| POST, GET | `/images` | Google Images results with full-size image URLs and dimensions. |
| POST, GET | `/news` | The Google News tab, with source, publish time and site icon. |
| POST, GET | `/videos` | The Google Videos tab, with duration, channel and platform. |
| POST, GET | `/shopping` | Google Shopping products with price, discount, delivery and rating. |
| POST, GET | `/places` | Local results (the Places tab): rating, address, category and opening hours. |
| POST, GET | `/maps` | Google Maps places with coordinates, place id and CID. |
| GET | `/requests/{requestId}` | A request answered 202, once it is ready |
| GET | `/account` | Your credit balance |
Start here
- Quickstart: a key and your first request in two minutes.
- Authentication: how to send the key.
- Credits, rate limits and errors: what a request costs and what can go wrong.
Moving from Serper? Read Migrate from Serper.
Machine-readable
Every page of these docs is also available as Markdown: add .md to its URL, for example /docs/quickstart.md.