Keyword Analysis API

Get the best primary keyword and 6 best supporting keywords with target keyword density, plus the ideal target word count to optimize your page or post to rank for SEO & LLMs. You'll also get the exact ranking pages used to make the recommendation.

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

OpenAPI MCP endpoint OAuth metadata llms.txt well-known llms.txt Swagger Docs

What you get

A compact data-backed SEO recommendation your agent or writer can use before drafting a page to set it up for ranking success.

Primary target

A recommended primary keyword based on what is closest to the pages already ranking for your original input keyword.

Usage targets

Suggested word count for your page or post, plus keyword 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

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

-Your agents can write posts using the keywords Google is actively ranking, rather than just what it _thinks_ will rank

-Sanity-check which keyword variant would be best for your primary keyword choice

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

-Get the actual ranking URLs so you or your agent 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.