Keyword Analysis API

Turn a target keyword into a usable optimization brief. In one request, you get a recommended primary keyword, a target word count, supporting keyword usage targets, and the exact ranking pages used to make the recommendation.

Access: Email code + API token Flow: Async job polling Pricing: 25 free, then $0.05

OpenAPI llms.txt well-known llms.txt Swagger Docs

What you get

A compact SEO recommendation you can hand to an agent or writer before drafting a page.

Primary target

A recommended primary keyword based on what is closest to the pages already ranking.

Usage targets

Suggested word count plus density targets for the primary keyword and six supporting keywords.

Source pages

The exact ranking URLs used in the analysis, with order, excerpts, and word counts.

Why you’d use it

It gives agents and writers a clear optimization target instead of guessing which keyword variant, page length, and supporting terms matter most.

-Brief a writer or agent before drafting a page

-Sanity-check which keyword variant is closest to what already ranks

-Estimate how long a page should be before you write it

-Pull the actual ranking URLs so you can inspect them yourself

What to send

Create an account with POST /auth/create-account, verify it with POST /auth/verify-account, then queue analysis with POST /keyword-analysis/analyze.

{
  "keyword": "auto body repair pearland tx",
  "top_n_results": 5,
  "include_page_content": false
}

What comes back

-A recommended primary keyword to target

-A suggested word count anchor

-A density target for the primary keyword

-Six secondary keywords with their own usage targets

-The exact analyzed ranking pages with analysis_rank, URLs, excerpts, and word counts

Example response

{
  "keyword": "auto body repair pearland tx",
  "suggested_word_count": 550,
  "total_results_analyzed": 4,
  "results": [
    {
      "analysis_rank": 1,
      "title": "Collision Repair in Pearland",
      "url": "https://example.com/pearland-collision-repair",
      "rank": 1,
      "word_count": 612
    }
  ],
  "analysis": {
    "primary_keyword": "collision repair pearland",
    "primary_keyword_density": {
      "keyword": "collision repair pearland",
      "occurrence_count": 4,
      "occurrences_per_result": 1.0,
      "total_word_count": 2287,
      "density_percentage": 0.17
    },
    "secondary_keywords": [
      {
        "keyword": "collision repair",
        "occurrence_count": 13,
        "occurrences_per_result": 3.25,
        "total_word_count": 2287,
        "density_percentage": 0.57
      },
      {
        "keyword": "free estimate",
        "occurrence_count": 5,
        "occurrences_per_result": 1.25,
        "total_word_count": 2287,
        "density_percentage": 0.22
      }
    ]
  }
}

Billing behavior

Analysis is only billable on successful completed requests. If free quota is exhausted, the API returns a billing-required response with a hosted Stripe setup URL.