integrations.sh
← all integrations

goog.io | Unoffical Google Search API

OpenAPI apis-guru search

Intoduction

This is the OpenAPI V3 documentation for

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 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 TypeHeader NameExample Token
API Keyapikeyc5bfb018-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 .

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:

HeaderDescription
X-RateLimit-LimitThe maximum number of requests that the consumer is permitted to make.
X-RateLimit-RemainingThe number of requests remaining in the current rate limit window.
X-RateLimit-ResetThe 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":

json
{  "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).

Homepage
https://api.apis.guru/v2/specs/goog.io/0.1.0.json
Provider
goog.io
OpenAPI version
3.0.2
Spec (JSON)
https://api.apis.guru/v2/specs/goog.io/0.1.0/openapi.json
Spec (YAML)
https://api.apis.guru/v2/specs/goog.io/0.1.0/openapi.yaml

Tools (8)

Extracted live via the executor SDK.

  • crawl.getOperation

    Perform Google Search

    Parameters

    query : the string query to perform search. supports advance queries. Check out guide for formating

    Returns

    json: a the html source of the results page

  • images.getOperation

    Perform Google Image Search

    Parameters

    query : the string query to perform search. supports advance queries.

    Returns

    json: a list of results with the link, description, and title for each result

  • news.getOperation

    Perform Google News Search

    Parameters

    query : the string query to perform search for Google news. A simple query for president will be q=president. An example of multiple keyword would be q=news+about+presdient+trump. News can also be filtered by country and language. For US news and in English the query will be q=trump&ceid=US:en for news in Great Britian the query will be q=trump&ceid=GB:en

    Returns

    json: {"feed": { "title" : "trump" ...} , "entites": [ {"title" : "Trump doubles down on divisive messaging in speech to honor Independence Day - CNN", "links": []} ...]}

  • root.getTheStatusOfTheApiService

    It "status" == true then API is up, else the API is down

  • search.getOperation

    Perform Google Search

    Parameters

    query : the string query to perform search. supports advance queries. Check out guide for formating

    Returns

    json: a list of results with the link, description, and title for each result

  • serp.postOperation

    Perform Google Search and search for website in Search Engine Results Pages (SERP)

    Parameters

    query : the string query to perform search. supports advance queries. Check out guide for formatting, it is recommended to set the query &num=100

    Returns

    json: a list of results with the query, website, searched_results, and position. json["position"] will be set to -1 if website is not found in results

  • openapi.previewSpec

    Preview an OpenAPI document before adding it as a source

  • openapi.addSource

    Add an OpenAPI source and register its operations as tools