Find information on products from around the globe. The API supports UPC, EAN, and ISBN barcode numbers, and info returned includes product name, description, brand, image URL, and more.

# 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](https://github.com/googio/googio_examples) 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](/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**": ```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).

The Travel Partner API provides you with a RESTful interface to the Google Hotel Center platform. It enables an app to efficiently retrieve and change Hotel Center data, and is thus suitable for managing large or complex accounts.

# Google Home Local API This is an unofficial documentation of the local API used by the Home app to communicate with GH devices. [GitHub Repo](https://github.com/rithvikvibhu/GHLocalApi) [](https://github.com/rithvikvibhu/GHLocalApi/stargazers) [](https://github.com/rithvikvibhu/GHLocalApi/blob/master/LICENSE.md) ## Getting Started Requests must be made over HTTPS, port 8443, so the base URL for these endpoints is: `https://:8443/setup/` Get the IP of Google Home from the Google Home app (Device Settings -> End of the list) or from your router. GET requests are simple, in the browser kind. POST requests need to set the header (when there's a body): `content-type: application/json` ## Authentication Since June 2019, most requests (with exceptions like `/setup/eureka_info`) need a local authorization token. There are 3 kinds of tokens involved here: ### Local Authorization Token This token must be sent in all requests in the header `cast-local-authorization-token`. It is short-lived (~1 day) and may change unexpectedly (with a sync, change in homegraph, etc.) ##### Get this token - With access to an android device, [get this token directly by either method](https://gist.github.com/rithvikvibhu/1a0f4937af957ef6a78453e3be482c1f). - Without a device, or to integrate it with a script, use an access token to get the homegraph and extract the token. To get an access token, read the next section. Check the example section for more info. ### Access Token This is a standard google oauth2 access token. It is in the form `ya29.***`. This gives access to the Google Home Foyer API. These expire in an hour. Use this to get the homegraph (and then the local authorization token above). ##### Get this token To get this access token, either a Google account username/password or a Google Master Token is needed. More info in the gist. Use the script [from this gist](https://gist.github.com/rithvikvibhu/952f83ea656c6782fbd0f1645059055d). ### Master Token This is in the form `aas_et/***` and can be used to request access tokens. ##### Get this token The same [script in the gist](https://gist.github.com/rithvikvibhu/952f83ea656c6782fbd0f1645059055d) that gets the access token can also get the master token. Needs Google account creds. ## Example Here's the whole flow from just a pair of username/password to using the local API. Prerequisites: - [grpcurl](https://github.com/fullstorydev/grpcurl) - [Proto files](https://drive.google.com/drive/folders/1RvnN3y-G23pd2SWHmfV_7sef8QU5GNF4?usp=sharing) (preserve folder structure) ### 1. Get an access token with the script - Download get_tokens.py - Fill in username and password ```sh python3 get_tokens.py # Note down the access token printed. ``` ### 2. Use the access token and get home graph - This prints the json and uses jq to parse and filter out the fields deviceName and localAuthToken - This will give a list of all devices and their local auth tokens ```sh ./grpcurl -H 'authorization: Bearer ya29.a0Af****' \ -import-path /path/to/protos \ -proto /path/to/protos/google/internal/home/foyer/v1.proto \ googlehomefoyer-pa.googleapis.com:443 \ google.internal.home.foyer.v1.StructuresService/GetHomeGraph | jq '.home.devices[] | {deviceName, localAuthToken}' # Note down the local auth token for the device you want. ``` ### 3. Make the call to the local device using the local auth token ```sh curl -H "cast-local-authorization-token: LOCAL_AUTH_TOKEN" --verbose --insecure https://192.168.0.18:8443/setup/bluetooth/status ```

Views Abusive Experience Report data, and gets a list of sites that have a significant number of abusive experiences.

Retrieves the list of AMP URLs (and equivalent AMP Cache URLs) for a given list of public URL(s).

An API for controlling access to data by Google personnel.

An API for setting attribute based access control to requests to Google Cloud services.

Google Domains ACME DNS API that allows users to complete ACME DNS-01 challenges for a domain.

Accesses your bidding-account information, submits creatives for validation, finds available direct deals, and retrieves performance reports.

Accesses the latest features for managing Authorized Buyers accounts, Real-Time Bidding configurations and auction metrics, and Marketplace programmatic deals.

Views Ad Experience Report data, and gets a list of sites that have a significant number of annoying ads.

Admin SDK lets administrators of enterprise domains to view and manage resources like user, groups etc. It also provides audit and usage reports of domain.

The AdMob API allows publishers to programmatically get information about their AdMob account.

Accesses AdSense publishers' inventory and generates performance reports.

Generates performance reports, generates ad codes, and provides publisher management capabilities for AdSense Hosts.

An API for accessing Advisory Notifications in Google Cloud

Manages alerts on issues affecting your domain. Note: The current version of this API (v1beta1) is available to all Google Workspace customers.

Views and manages your Google Analytics data.