> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Keyword Suggestions

> Get Amazon search autocomplete suggestions for keyword research.

## Query Parameters

**query** `string` *required*

Partial search term to expand into suggestions.

Example: `wireless ear`

**domain** `string` (default: com)

Amazon marketplace TLD or code. Suggestions are localized per marketplace.

Examples: `com`, `co.uk`, `de`

## Response

**query** `string`

The partial term that was expanded.

**domain** `string`

Marketplace the suggestions came from.

**suggestions** `array`

Array of suggested search phrases.

**Suggestion object**

**value** `string`

Suggested search phrase.

**alias** `string`

Department alias the suggestion is scoped to, if any (nullable).

### Example Response

```json theme={null}
{
  "query": "wireless ear",
  "domain": "com",
  "suggestions": [
    { "value": "wireless earbuds", "alias": "aps" },
    { "value": "wireless earbuds bluetooth", "alias": "aps" },
    { "value": "wireless earphones", "alias": "electronics" }
  ]
}
```

> [!NOTE]
>
> Each autocomplete request costs **2 credits**. Failed requests are not charged.


## OpenAPI

````yaml GET /v1/amazon/autocomplete
openapi: 3.1.0
info:
  title: ScrapeBadger Amazon API
  version: 1.0.0
  description: >-
    Amazon marketplace scraping API for searching products, fetching product
    details, offers, reviews, listings, sellers, and reference data across 20
    marketplaces.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/amazon/autocomplete:
    get:
      tags:
        - Amazon Search
      summary: Keyword Suggestions
      description: Get Amazon search autocomplete suggestions for keyword research.
      operationId: amazonAutocomplete
      parameters:
        - name: query
          in: query
          required: true
          schema:
            type: string
          description: Partial search term to expand into suggestions.
        - name: domain
          in: query
          schema:
            type: string
            default: com
          description: Amazon marketplace TLD or code (com, co.uk, de, ...).
      responses:
        '200':
          description: Autocomplete suggestions
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: string
                  domain:
                    type: string
                  suggestions:
                    type: array
                    items:
                      type: object
                      properties:
                        value:
                          type: string
                          description: Suggested search phrase.
                        alias:
                          type: string
                          nullable: true
                          description: >-
                            Department alias the suggestion is scoped to, if
                            any.
              example:
                query: wireless ear
                domain: com
                suggestions:
                  - value: wireless earbuds
                    alias: aps
                  - value: wireless earbuds bluetooth
                    alias: aps
                  - value: wireless earphones
                    alias: electronics
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.