---
title: "Metrics for specific keywords"
method: POST
path: "/v1/data/seo/keyword-overview"
tags: ["SEO: Keywords"]
---

# Metrics for specific keywords

`POST /v1/data/seo/keyword-overview`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/seo/keyword-overview`
- Auth: API key in header `Authorization`

Returns full metrics for the exact keywords you pass: search volume, CPC and competition (keyword_info), keyword difficulty (keyword_properties.keyword_difficulty), trend history and SERP characteristics. Use this when you already know the keywords and need their numbers; use keyword_ideas when you need to discover keywords.

## Request body

- object
  - `keywords` string[], required: The exact keywords to look up (1-700). Cost scales with the number of keywords.
  - `location_code` integer: Geo target as a location code. Default 2840 (United States).
  - `language_code` string: Two-letter language code. Default 'en'.

## Response `200`

Per-keyword metrics in `result[0].items`.

- object

## Other responses

- `400`: Bad request or upstream task error.
- `401`: Unauthorized.
- `429`: Too many requests.
- `5XX`: Upstream error.

---

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