Text search API documentation
Google search results API documentation
Send one server-side request and receive structured Google text search results with country, language, and page targeting.
One endpoint for text search
Send a JSON body with an HTTP POST request to /api/v1/search. Authenticate with the X-API-Key header or an Authorization Bearer token.
Search parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| q | string | Yes | None | The text to search for. Use 1 to 300 characters. |
| gl | country code | No | us | The country used to localize the search results. |
| hl | language code | No | en | The language used for the search interface and results. |
| page | integer | No | 1 | The result page to request. Accepted values are 1 through 10. |
Credits
One successful API or Playground response uses one credit, including a cached response. Failed requests do not use a search credit. The Free plan includes 100 credits each calendar month.
Errors
| HTTP | Code | Meaning |
|---|---|---|
| 400 | INVALID_SEARCH_REQUEST or INVALID_JSON | The request body is missing, malformed, or contains an invalid value. |
| 401 | AUTH_REQUIRED or INVALID_CREDENTIALS | The request does not include a valid API key or account session. |
| 402 | CREDITS_EXHAUSTED | The account does not have a credit available for this request. |
| 413 | REQUEST_BODY_TOO_LARGE | The JSON request body is larger than the accepted limit. |
| 502 | PROVIDER_UNAVAILABLE or PROVIDER_INVALID_RESPONSE | The upstream search service could not return a valid response. |
| 504 | PROVIDER_TIMEOUT | The upstream search did not finish before the request deadline. |