Skip to main content
POST
Get Google search suggestions for a keyword
Returns Google search suggestions for a keyword.

Request

query is required.

Response

If successful, the response body contains the standard envelope. data.results[] contains the suggestions, best first. The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.

Optional parameters

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

This method is not paginated. A single request returns the complete result.
  • Google Search: Accepts a suggestion as query. Searches Google and returns results, the AI Overview, the knowledge panel and related questions.
  • Google News: Accepts a suggestion as query. Searches Google News by keyword, date, site and country, or returns headlines by topic.
  • Google Trends interest over time: Accepts a suggestion as queries. Returns Google Trends search interest over time, newest first, with one value per query.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required
Required string length: 1 - 200
country
string
default:us

ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.

Pattern: ^[A-Za-z]{2}$
language
string
default:en

BCP 47 language tag, e.g. en or pt-BR. Any case is accepted.

Pattern: ^[A-Za-z]{2,3}(?:[-_][A-Za-z0-9]{2,4})?$

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required