---
title: "Suggest Google search queries"
method: GET
path: "/google/suggest"
tags: ["Google"]
---

# Suggest Google search queries

`GET /google/suggest`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/google/suggest`
- Auth: API key in header `x-api-key`

Returns Google autosuggest query completions from the public unauthenticated suggest JSON endpoint. `source` selects the web, YouTube, or shopping suggestion list, and `rich=true` adds a type, relevance score, and short description to each suggestion.

## Query parameters

- `q` string, required
- `count` integer
- `country` string
- `lang` string
- `source` 'web' | 'youtube' | 'shopping'
- `rich` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoogleSuggestResponseDoc
  - `code` integer
  - `data` GoogleSuggestResponse
    - `query` string: Query prefix the suggestions were requested for.
    - `source` string: Suggestion list used: `web`, `youtube` or `shopping`.
    - `suggestions` GoogleSuggestionResult[]: Search suggestions Google returned, in order.
      - `description` string: Short descriptor Google shows beside the suggestion. Only set when the request used `rich=true`.
      - `position` integer: Rank of the suggestion in the list, starting at 1.
      - `query` string: Suggested search query.
      - `relevance` integer: Relevance score Google gives the suggestion. Only set when the request used `rich=true`.
      - `type` string: Suggestion type as Google labels it, for example `QUERY`. Only set when the request used `rich=true`.
  - `msg` string

## Other responses

- `400`: Missing or invalid query
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: Google upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)