# 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).
639 api specs