---
title: "Generate keyword ideas"
method: GET
path: "/v3/keyword-research/"
tags: ["keyword-research"]
---

# Generate keyword ideas

`GET /v3/keyword-research/`

Return keyword suggestions with search volume, competition level, and CPC data.

## Query parameters

- `teamId` string
- `keyword` string
- `page_url` union
  - string
  - string, uri
- `location_ids` string
- `language_id` string

## Response `200`

Default Response

- object
  - `exact_keyword` object[], required
    - `keyword` string, required
    - `monthlysearch` number, required
    - `difficulty` string, required
    - `competition_score` number, required
    - `annotation` string, required
    - `cpc` number, required
    - `historic_data` object[], required
      - `year` number
      - `month` number
      - `search_volume` number
  - `related_keywords` object[], required
    - `keyword` string, required
    - `monthlysearch` number, required
    - `difficulty` string, required
    - `competition_score` number, required
    - `annotation` string, required
    - `cpc` number, required
    - `historic_data` object[], required
      - `year` number
      - `month` number
      - `search_volume` number
  - `perCountry` object[]
    - `countryId` string, nullable, required
    - `count` number, required
    - `exact_keyword` object[], required
      - `keyword` string, required
      - `monthlysearch` number, required
      - `difficulty` string, required
      - `competition_score` number, required
      - `annotation` string, required
      - `cpc` number, required
      - `historic_data` object[], required
        - `year` number
        - `month` number
        - `search_volume` number
    - `related_keywords` object[], required
      - `keyword` string, required
      - `monthlysearch` number, required
      - `difficulty` string, required
      - `competition_score` number, required
      - `annotation` string, required
      - `cpc` number, required
      - `historic_data` object[], required
        - `year` number
        - `month` number
        - `search_volume` number

## Other responses

- `400` — Default Response
- `500` — Default Response
- `503` — Google Ads credentials not configured

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/4532e367c679/schema)