Google Search API — FetchLayer Docs
Documentation menu
FetchLayer FetchLayer API

Google Search API v1

Read Google results pages as structured JSON — the organic ranking and every feature around it — check where a site ranks for a query, and pull Google’s search suggestions, from https://api.fetchlayer.dev/google-search. Everything returned is what Google shows a visitor in the country and city you choose — no Google account, just your FetchLayer key. FetchLayer is not affiliated with, endorsed by, or sponsored by Google.

OpenAPI JSON

Available endpoints

The whole results page, not just ten links

/search returns the organic results with position, title, URL, the address line Google prints, site name, snippet, date and sitelinks, and alongside them whatever Google showed: the answer box, People also ask questions, related searches, top stories, videos and short videos, discussions, local business results with rating and review count, the knowledge panel, and ads — which sit in their own list and never shift a position. Each field is empty or null when Google did not show it.

Rank checks cost one credit at any depth

/rank-check takes a query and a domain or URL, examines up to 100 organic results, and returns whether the site was found, its best position and page, every match, and where else it appeared on the pages read. A rank check costs 1 credit regardless of depth: scanning 100 positions across 10 or more result pages is billed as one request. serpPagesFetched reports how many result pages were read and is never billed.

Everything else bills on what it reads: /search one request per result page, /autocomplete one per call. /resolve-url makes no request to Google and is free.

Results depend on who is searching

Google ranks differently by country, language, city and device. Every request defaults to a US, English, desktop searcher; pass country, language, location (for example "Austin,Texas,United States") and device to see what someone there sees. Positions also shift over time, so track them rather than reading one check as permanent.

Every response carries a notes array. It is where a result whose link could not be followed, or a page that could not be read, announces itself.

What this API does not return

  • A total-result count. The “about N results” figure is not returned.
  • AI Overviews, or People also ask answers. People also ask comes back as the questions only.
  • Videos, shorts and discussions on non-English pages. They are detected on English-language results pages only.
  • A fixed number of results a page. Google shows between 6 and 10 organic results a page and ignores a requested count.