> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# SEO guides

> Compare keyword demand in one market, find the pages that rank for the topic and hand an editor a sourced decision sheet.

To plan an SEO content section, compare keyword demand in one market with `POST /v1/seo/keyword-overview`, find the pages that already rank for the topic with `POST /v1/seo/ranked-keywords`, and hand your editor a sheet that connects each keyword, ranking page and proposed piece of content. The example below plans a coffee-machine maintenance section.

## 1. Compare a batch of keywords

Send JSON to `POST https://api.beatapi.io/v1/seo/keyword-overview` with BeatAPI Bearer authentication.

```json
{"keywords":["descale coffee machine","clean coffee grinder"],"country":"us","language":"en"}
```

Compare volume, intent and difficulty for each keyword in `results`. Give each keyword a recommendation, such as “Write a step-by-step descaling tutorial.” Leave missing volume blank. If customers already ask the question, keep the customer excerpts as a separate reason to cover the topic.

## 2. See how other sites answer the question

Send the body below to `POST /v1/seo/ranked-keywords`:

```json
{"domain":"example.com","contains":"descale","country":"us","language":"en","limit":5}
```

Save the matching keywords, page URLs, `position` and `position_seen_at`. Read the selected pages to see which machine models and conditions each page covers. To find sites that cite a page, request domain backlinks with `POST /v1/seo/backlinks` and filter the returned rows by destination URL. Record the scope of each batch.

## 3. Hand off an editorial decision sheet

In each row, record the keyword, market, observation date, related ranking page and proposed angle. For example, if a competitor's guide already covers the general descaling steps, propose a section on descaling in hard-water areas and flag the equipment manuals to check. Save `billed_rows` and `usage.price_usd` for each request. See [BeatAPI pricing](https://beatapi.io/pricing).

[SEO API fields and billing](/seo) · [SEO answers](/faq/seo)