API catalog / Google API / Search the web

Google Search API

Ranked Google web results as clean, stable JSON — positions, titles, snippets and publish dates, page after page.

GEThttps://api.endpointry.com/v1/google/web-search

Returns ranked web results, exactly `per_page` per response (up to 10) until the result set ends. Pagination continues while results remain — typically 100–250 per query — and stops with `meta.pagination.next_page: null`. Each result carries its absolute position, so ranking is stable across pages. Results reflect a globally neutral locale; country and language targeting are not yet available.

Query parameterseditable
query *string
page *number · 1–50
per_page *number · 1–10
Response fields (data)
results*array<object>
position*integerAbsolute rank across the whole result set, starting at 1.
url*string · uri
domain*string
title*string
snippet*string | null
published_at*string · date-time | nullPublication date when the source exposes one, otherwise null.
Response meta

Platform fields, identical on every endpoint — what they mean.

Request
curl "https://api.endpointry.com/v1/google/web-search?query=best+crm+software" \
  -H "Authorization: Bearer sk_live_..."
Loading…
Responseexample
200 · application/json
{
  "meta": {
    "request_id": "req_7729f93d3facf68ff83e5c50",
    "as_of": "2026-07-31T12:00:00.000Z",
    "cache": "MISS",
    "pagination": {
      "page": 1,
      "next_page": 2,
      "limit": 10,
      "returned": 10
    }
  },
  "data": {
    "results": [
      {
        "position": 1,
        "url": "https://www.salesforce.com/crm/best-crm/",
        "domain": "www.salesforce.com",
        "title": "Best CRM Software: Everything To Consider",
        "snippet": "Learn what to look for when comparing CRM platforms, from pipeline management to reporting and automation.",
        "published_at": null
      },
      {
        "position": 2,
        "url": "https://www.pipedrive.com/en/crm/compare/crm-tool",
        "domain": "www.pipedrive.com",
        "title": "Compare CRM Tools",
        "snippet": "A side-by-side comparison of popular CRM tools for sales teams.",
        "published_at": "2026-01-27T00:00:00.000Z"
      }
    ]
  }
}

What teams build with it

  • SERP monitoring and rank tracking with absolute, page-stable positions
  • Market and competitor research over live web results
  • Search context for LLM and RAG pipelines, in a schema that never shifts
  • Content research at scale — every query returns the same shape

Frequently asked questions

How many results can I get per query?

Each response returns exactly per_page results (up to 10). Pagination continues while results remain — typically 100–250 per query — and stops with meta.pagination.next_page: null.

Are result positions stable across pages?

Yes. Each result carries its absolute position in the ranking, so page 3 continues exactly where page 2 ended and positions never restart.

Can I target a specific country or language?

Not yet. Results reflect a globally neutral locale; country and language targeting are on the roadmap.

How fresh are the results?

Every response carries meta.as_of with the exact snapshot time. Repeat queries are served from a short-lived cache, which is why paging through results is consistent and fast.

Google Search API · Endpointry