---
title: "Keyword demand check for up to 1000 chosen terms: search volume, CPC, advertising competition and available monthly history from Google Ads data. Advertising competition is not organic SEO difficulty."
method: POST
path: "/v1/keyword-metrics"
tags: ["SEO"]
---

# Keyword demand check for up to 1000 chosen terms: search volume, CPC, advertising competition and available monthly history from Google Ads data. Advertising competition is not organic SEO difficulty.

`POST /v1/keyword-metrics`

## Request

- Base URL: `https://agent.connskill.com` (the document declares no server; this is the origin it was published from)
- URL: `https://agent.connskill.com/v1/keyword-metrics`
- Auth: none declared

## Request body

- object
  - `keywords` string[], required: Keywords to look up. A single string is also accepted and treated as a one-element list.
  - `location_code` integer
  - `language_code` string

## Response `200`

Report delivered

- object
  - `status` string
  - `items` object[]
    - `keyword` string
    - `searchVolume` integer
    - `cpc` number
    - `competition` number
    - `monthly` object[]
      - `year` integer
      - `month` integer
      - `searchVolume` integer

## Other responses

- `402`: Payment Required

---

[API](https://skmtc.dev/connskill/apis/connskill-growth-services.md) · [All operations](https://skmtc.dev/connskill/apis/connskill-growth-services/llms.txt) · [OpenAPI document](https://skmtc.dev/connskill/apis/connskill-growth-services/revisions/aae873ea0805?raw)
