---
title: "Expand a seed phrase via Google Suggest"
method: POST
path: "/v1/serp/autocomplete"
tags: ["SERP"]
---

# Expand a seed phrase via Google Suggest

`POST /v1/serp/autocomplete`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/serp/autocomplete`
- Auth: HTTP bearer

Harvests Google Suggest keyword expansions for a seed phrase.
Synchronous (no async job). When `expand` is true, fans out across
a–z and intent modifiers and merges the suggestions, de-duplicated
case-insensitively in first-seen order.

## Request body

- object
  - `seed` string, required: Keyword/phrase to expand
  - `expand` boolean: Fan out across modifiers
  - `hl` string: Language code
  - `gl` string: Country/region code

## Response `200`

Suggestions harvested

- object
  - `seed` string, required
  - `suggestions` string[], required
  - `expandedFrom` object, required: Map of modifier label → suggestions it produced (empty when expand=false)

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)