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

  1. Quickstart: a key and your first request in two minutes.
  2. Authentication: how to send the key.
  3. 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.