Skip to navigation

SEO guides

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.

{"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:

{"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.

SEO API fields and billing · SEO answers