API catalog / Google API

Google API

Preview

Google web search, knowledge panels, query suggestions and dictionary lookups with stable schemas.

https://api.endpointry.com/v1/google

Quick start

curl
curl "https://api.endpointry.com/v1/google/web-search?query=best+crm+software" \
  -H "Authorization: Bearer sk_live_..."
  • • Authentication: Authorization: Bearer with your single platform key
  • • Envelope: every success response is { data, meta }
  • • Errors: RFC 9457 problem+json with stable codes
  • • Pagination: opaque cursors via meta.next_cursor

Example response

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"
      }
    ]
  }
}

Endpoints

GET/v1/google/rank

Check a domain's rank

Reports where a domain ranks for a query, scanning the whole measured result set — typically 100–250 results. Returns the best position, every appearance of the domain with its exact page, and `results_scanned` so a `null` position always names the set it was measured against. Shares its snapshot with `/web-search`, so a check right after a search costs nothing extra. Results reflect a globally neutral locale; country and language targeting are not yet available.

Query parameterseditable
query *string
domain *string
mode *string
Response fields (data)
query*string
domain*string
mode*"exact" | "subdomains"
position*integer | null
matches*array<object>
position*integer
url*string · uri
title*string
results_scanned*integer
Response meta

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

Request
curl "https://api.endpointry.com/v1/google/rank?query=best+crm+software&domain=pipedrive.com" \
  -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"
  },
  "data": {
    "query": "best crm software",
    "domain": "pipedrive.com",
    "mode": "subdomains",
    "position": 2,
    "matches": [
      {
        "position": 2,
        "url": "https://www.pipedrive.com/en/crm/compare/crm-tool",
        "title": "Compare CRM Tools"
      },
      {
        "position": 41,
        "url": "https://www.pipedrive.com/en/blog/crm-comparison",
        "title": "CRM Comparison: Top Tools Reviewed"
      }
    ],
    "results_scanned": 187
  }
}
GET/v1/google/knowledge-panel

Get the knowledge panel for a query

Returns structured entity data — name, type, summary, image and attributes — for queries that resolve to a known entity. Returns `404 NOT_FOUND` when the query has no panel. Sharing a warm result set with `/web-search`, so a lookup after a search is served from cache.

Query parameterseditable
query *string
Response fields (data)
name*string
label*string | null
description*object | null
text*string
source_url*string · uri | null
source_name*string | null
image*object | null
url*string · uri
width*integer | null
height*integer | null
page_url*string · uri | null
attributes*array<object>
label*string
values*array<string>
Response meta

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

Request
curl "https://api.endpointry.com/v1/google/knowledge-panel?query=anthropic" \
  -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"
  },
  "data": {
    "name": "Claude",
    "label": "Language model",
    "description": {
      "text": "Claude is a family of large language models developed by Anthropic.",
      "source_url": "https://en.wikipedia.org/wiki/Claude_(language_model)",
      "source_name": "Wikipedia"
    },
    "image": {
      "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:UQV8oMkcm41-NM",
      "width": 268,
      "height": 188,
      "page_url": "https://www.anthropic.com"
    },
    "attributes": [
      {
        "label": "Developer",
        "values": [
          "Anthropic"
        ]
      }
    ]
  }
}
GET/v1/google/autocomplete

Get query suggestions

Returns the suggestions Google offers for a partial query, in rank order, plus a spelling correction when the input looks misspelled. Each suggestion is provided as plain text and with highlight markup, and carries entity details when the suggestion maps to one. Useful for keyword research and search-as-you-type experiences.

Query parameterseditable
query *string
Response fields (data)
suggestions*array<object>
position*integer
keyword*string
keyword_html*string
entity*object | null
title*string
label*string | null
image_url*string · uri | null
spelling_suggestion*string | null
Response meta

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

Request
curl "https://api.endpointry.com/v1/google/autocomplete?query=best+crm" \
  -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"
  },
  "data": {
    "suggestions": [
      {
        "position": 1,
        "keyword": "anthropic claude",
        "keyword_html": "anthropic<b> claude</b>",
        "entity": {
          "title": "Anthropic",
          "label": "Artificial intelligence company",
          "image_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTCbP0WqDxmPhD2"
        }
      },
      {
        "position": 2,
        "keyword": "anthropic api pricing",
        "keyword_html": "anthropic<b> api pricing</b>",
        "entity": null
      }
    ],
    "spelling_suggestion": "anthropic"
  }
}
GET/v1/google/dictionary

Look up a word

Returns the dictionary entry for an English word: syllabification, phonetic pronunciations with audio, etymology, and one entry per part of speech with its inflections, numbered senses, synonyms and usage examples. Returns `404 NOT_FOUND` when the word has no entry. Definitions are stable, so responses are cached for 24 hours.

Query parameterseditable
word *string
Response fields (data)
word*string
syllables*string | null
etymology*string | null
pronunciations*array<object>
text*string
notation*string | null
audio_url*string · uri | null
entries*array<object>
part_of_speech*string
inflections*array<object>
label*string
text*string
definitions*array<object>
text*string
synonyms*array<string>
examples*array<string>
Response meta

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

Request
curl "https://api.endpointry.com/v1/google/dictionary?word=serendipity" \
  -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"
  },
  "data": {
    "word": "serendipity",
    "syllables": "ser·en·dip·i·ty",
    "etymology": "1750s: coined by Horace Walpole, suggested by The Three Princes of Serendip, the title of a fairy tale in which the heroes 'were always making discoveries, by accidents and sagacity, of things they were not in quest of'.",
    "pronunciations": [
      {
        "text": "/ˌserənˈdipədē/",
        "notation": "IPA",
        "audio_url": "https://ssl.gstatic.com/dictionary/static/sounds/oxford/serendipity--_us_1.mp3"
      }
    ],
    "entries": [
      {
        "part_of_speech": "noun",
        "inflections": [
          {
            "label": "plural",
            "text": "serendipities"
          }
        ],
        "definitions": [
          {
            "text": "the occurrence and development of events by chance in a happy or beneficial way.",
            "synonyms": [
              "chance",
              "happy chance",
              "accident",
              "fluke"
            ],
            "examples": [
              "a fortunate stroke of serendipity"
            ]
          }
        ]
      }
    ]
  }
}

Ready to build with Google API?

Included in every plan — one subscription covers the whole catalog.