Google Site Search API Documentation

Endpoint

GET https://api.goanyapi.com/api/v1/google-site-search

GET https://api.goanyapi.com/api/v1/google-site-search

With the current configuration, each successful request costs 4 credits.

The current request cost follows the API configuration shown on this page.

Authentication

Authorization: Bearer YOUR_API_KEY

Request parameters

Parameter	Required	Description
`site`	Yes	Domain to search, such as `example.com` or `www.example.com`. Maximum 253 characters. Do not include a protocol, port, path, or `site:` prefix.
`qdr`	No	Optional recency window: `h`, `d`, `w`, `m`, or `y`. Omit it for Any Time.
`gl`	No	Two-letter country code, such as `us`.
`hl`	No	Two-letter interface language code, such as `en`.
`device`	No	`desktop`, `mobile`, `ios`, `iphone`, `ipad`, `ios_tablet`, `android`, or `android_tablet`.
`browser`	No	`chrome`, `safari`, or `firefox`. Firefox can only be combined with desktop.
`safe`	No	SafeSearch setting: `active` or `off`.

The endpoint does not accept raw q, tbs, search_type, tbm, or udm parameters.

Request example

curl --get 'https://goanyapi.com/api/v1/google-site-search' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data-urlencode 'site=example.com' \
  --data-urlencode 'qdr=w'

This request applies the following search scope:

site:example.com

This example uses qdr=w to limit the query to the past week.

Response example

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "google-site-search",
    "remainingCredits": 96,
    "query": {
      "site": "example.com",
      "qdr": "w"
    },
    "siteCount": 128000,
    "searchTime": 0.42,
    "organic": [
      {
        "link": "https://example.com/article",
        "source": "Example",
        "display_link": "https://example.com › article",
        "title": "Example Article",
        "description": "An example search result.",
        "extensions": [
          {
            "inline": true,
            "type": "text",
            "text": "3 days ago",
            "rank": 1
          }
        ],
        "rank": 1,
        "global_rank": 1
      }
    ]
  }
}

Response fields

Field	Description
`data.endpoint`	Endpoint identifier: `google-site-search`.
`data.costCredits`	Credits consumed by this successful request.
`data.remainingCredits`	Credits remaining after the request.
`data.query`	Normalized public request parameters.
`data.siteCount`	Estimated total reported for the complete website query.
`data.searchTime`	Reported search processing time, when available.
`data.organic`	Organic results returned on the current result page.
`data.organic[].extensions`	Optional result metadata; with a recency filter, some rows may include a relative time hint.

siteCount is an estimate, not an exact indexed-page count or the number of rows in organic. It can vary over time and by country, language, device, and browser.

When qdr is set, some organic rows may include a relative time hint such as 3 days ago in extensions. It can be used as a recency or indexing reference, but the field is optional, may be absent from any row, and is not an exact crawl or first-indexed timestamp.

Billing

Credits are deducted only after the query returns a valid siteCount value.
Authentication failures, invalid parameters, failed queries, and incomplete results do not consume credits.

Google Site Search API

On this page