Intoduction

This is the OpenAPI V3 documentation for https://api.goog.io

An API to perform Google Searches. Extremely fast and accurate. Zero proxies. Clean USA IPs.

Simple to use API, but advance enough to support special parameters such as languages, country and geographic locality.

Googio is the ultimate search API for Google Searches, Google News, and Google SERP.

Docs

An Unofficial Google Search API

An API to perform Google Searches. Extremely fast and accurate. Zero proxies. Clean USA IPs.

Simple to use API, but advance enough to support special parameters such as languages, country and geographic locality.

Example Code

Check out Github repo for example code for calling the API with various languages.

Authentication

API Key

Optional API key for authenticated access. Note that we use "API key" interchangably in these docs.

Authenticated requests must include an apikey header containing your subscription's API Key.

| Security Schema Type | Header Name | Example Token | | --- | --- | --- | | API Key | apikey | c5bfb018-ab46-4e61-9271-4ec7e9c04a6e |

In the following example, YOU_APIKEY represents the auth token for your account.

curl --header 'apikey: YOU_APIKEY'

You can view and manage your API keys in the Dashboard.

Be sure to keep your API keys secure. Do not share them in publicly accessible areas such as GitHub, client-side code, and so forth.

Also note that all API requests must be made over HTTPS. Calls made over plain HTTP will attempt to be automatically upgraded to HTTPS, though this use cases is discouraged.

Rate Limits

API requests may be rate limited depending on your subscription plan and traffic patterns. The following response headers will be present in these cases:

| Header | Description | | ------ | ----------- | | X-RateLimit-Limit | The maximum number of requests that the consumer is permitted to make. | | X-RateLimit-Remaining | The number of requests remaining in the current rate limit window. | | X-RateLimit-Reset | The time at which the current rate limit window resets in UTC epoch seconds. |

When the rate limit is exceeded, an error is returned with the status "429 Too Many Requests":

{
  "error": {
    "code": "too_many_requests",
    "message": "Rate limit exceeded"
  }
}

Errors

This API uses conventional HTTP response codes to indicate the success or failure of API requests. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, endpoint not found, etc.). Codes in the 5xx range indicate an error with our API (these are rare).