Introduction
JustSERP is a JSON API for Google Search, Maps, News, Shopping, Flights and the rest of Google, Bing, YouTube, TikTok, Apple, AI answers, business reviews, shopping sites and any web page.
JustSERP turns search results and web pages into structured JSON. You send one request to the endpoint you want and get the parsed answer back, with nothing to run or maintain on your side.
curl -G "https://api.justserp.com/v1/google/search" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "q=plumber near me" \
--data-urlencode "hl=en" \
--data-urlencode "gl=us" \
--data-urlencode "location=Austin,Texas,United States"Endpoint families
| Family | What it returns | Examples |
|---|---|---|
| Search and places | Google Search, Light, Maps, Trends, News, Images, Videos, Shopping, Flights, Hotels, Patents and more; Bing, Yahoo, DuckDuckGo, YouTube, Apple Maps and App Store, Yelp and HiringCafe. | Google Search, Bing, YouTube |
| AI answers | What Google AI Overview, Google AI Mode, ChatGPT and Bing Copilot answer, with the businesses and sources they name. | AI Overview, ChatGPT |
| Reviews | A profile's rating and reviews from Google, Yelp, Facebook, Trustpilot, BBB, Angi, Yellow Pages, Healthgrades and Tripadvisor, plus "find" endpoints that look a business up. | Google reviews |
| Shopping and real estate | Walmart search, products and reviews; Zillow search and properties. | Walmart, Zillow |
| Social and code | Instagram, TikTok and GitHub profiles, posts, videos, comments and search. | TikTok, GitHub |
| Web page | Any page by its URL, as HTML or Markdown. | Web page |
| Jobs and snapshots | Cancel a request that is still running; open the saved copy of a page. | Cancel, Snapshot |
The API Reference lists all of them.
How every request looks
- A
GET /v1/<endpoint path>with the fields as query parameters (GET /v1/google/search?q=coffee&gl=us). Fields an endpoint does not use are ignored. Parameters shows how to encode lists, objects and special characters. - Authenticate with
X-API-Key: <key>,Authorization: Bearer <key>or theapikeyquery parameter. See Authentication. - A
200is the document itself:search_metadata,search_parametersandsearch_informationfirst, then the endpoint's blocks (such asorganic_results) at the top level. A200withparsed: falsemeans the page was fetched but not understood: retry it. - Inside a job, failed attempts are retried before the API answers: up to 5 attempts (8 for Google AI Overview, Google AI Mode and ChatGPT).
- A request with no answer by about 95 seconds gets
500job_timeout. Set your client timeout to about 100 seconds.
Where to go next
Quickstart
Get a key and make your first request in curl, JavaScript, Python or PHP.
Authentication
Send your key in the X-API-Key header or as a Bearer token.
Parameters
The request fields shared by every endpoint and each family's inputs.
Errors & billing
Every status code, what it means, whether to retry and what is charged.
Rate limits & concurrency
Timing, plan quotas and how many requests a key can run at once.
API Reference
Every endpoint with its request and response schemas.
OpenAPI spec
The API Reference is generated from an OpenAPI 3.1 file. Download it to generate a client or import it into your tooling: