SERP
What SERP means
SERP stands for search engine results page. For Google it is no longer a list of ten blue links: depending on the query it can hold ads, a knowledge panel, a local pack with a map, People also ask, videos, shopping carousels, and an AI Overview, with the organic links between them.
The same query does not produce the same SERP everywhere. Google changes the page by country, language, device, and location, and it changes over time as it re-ranks pages. A SERP you collect is a snapshot of one query, from one place, at one moment, which is why rank tracking tools fix those settings and record the date.
Clair's Google Search API returns one SERP per request for a query, country, and language, with each block Google showed parsed into its own field. Blocks Google did not show come back null or empty.
What a results page can show
Google builds each results page from blocks, and which ones appear depends on the query: a person's name brings a knowledge panel, a business type brings a local pack, a how-to question brings People also ask. These are the common ones, and where each appears in Clair's Google Search response.
| Block | What it is | In Clair's response |
|---|---|---|
| Organic results | The unpaid links, ranked by Google | results[], with position counted across pages |
| Ads | Paid links marked Sponsored, above and below the results | Not returned; removed from results[] |
| Knowledge panel | Facts about a person, place, or organisation, from the Knowledge Graph | knowledge_graph |
| People also ask | Related questions that expand into short answers | people_also_ask[], the questions only |
| Local pack | A map and a short list of businesses | local_results[] |
| Videos | A carousel of videos, mostly from YouTube | videos[] |
| Related searches | Other queries people search, listed at the end of the page | related_searches[] |
| Top stories | Recent news articles on the query | Not returned; the Google News API reads Google News |
| AI Overview | A generated summary with linked sources | Not returned; the Google AI Overview API reads it |
Why SERPs change by location
Google shapes results around where a search comes from. Queries with local intent, such as "coffee" or "dentist", change from one neighbourhood to the next, and most other queries change at least between countries, where Google favours local-language and local-domain pages.
Google reads the location from the browser's precise location when the user allows it, and otherwise from the IP address. So a search shows the SERP for wherever the searcher is, and seeing another place's results takes one of these:
- Another country: add gl with a country code to the search URL, as in google.com/search?q=coffee&gl=de, and hl for the language, as in hl=de. Google documents both for its search APIs; on google.com they work but are not a promise.
- Another city: change the location the browser reports, for example with the Sensors panel in Chrome's developer tools, or search through a proxy in that city. Rank trackers and many SERP APIs take a city name and pass it to Google in the uule parameter, which Google does not document.
- Clair's Google Search API: country and language per request. It routes the request from the country you name and does not target cities or coordinates.
How it appears in a response
GET /v1/google-search?q=albert+einstein&country=us&page=1 · query
{
"q": "albert einstein",
"language": "en",
"country": "us",
"page": 1
}Common questions
What does SERP stand for?
Search engine results page: the page a search engine shows for a query.
What are SERP features?
The blocks on a results page other than the organic links: ads, the local pack, People also ask, knowledge panels, video and image carousels, top stories, and AI Overviews.

Glassdoor API
Crunchbase API
Instagram API
Bloomberg API
Associated Press API