P
    PAYGSEO
    Keywords

    Keyword Discovery

    What keywords should I even be considering next?

    Compares your ranked keywords to competitors and surfaces opportunities you do not rank for.

    🤖 Also callable from any AI agent via REST API or MCP.

    What it does

    Keyword Discovery compares your rankings with selected competitors to surface the gaps worth exploring next.

    Best for

    Build a shortlist of new keyword ideas to validate.

    How it works

    1. Pull ranked keywords for your domain and selected competitors.
    2. Deduplicate and map keywords to competitor ranks.
    3. Flag whether you already rank and where.
    4. Classify intent.
    5. Calculate a priority score for sorting only.

    Outputs

    • Keyword and intent
    • You rank yes or no plus position
    • Competitor count
    • Competitor ranks by domain
    • Priority score for sorting

    Results screenshots

    Real screenshots from completed tool runs. Click any image to open the full results view.

    Keyword discovery results

    Review competitor keyword gaps, intent totals, and prioritized opportunities from a completed run.

    Common workflows

    Diagnose - Restructure - Expand

    You are unsure how existing pages fit together.

    1. Pillar or Supporting Page? - Determine the role of an existing page
    2. Keyword Discovery - Identify related keyword opportunities
    3. Winning Content Outline - Plan new supporting or pillar pages

    Compare - Decide - Build

    A competitor consistently outranks you.

    1. Keyword Discovery - See what competitors rank for that you do not
    2. Keyword Snapshot - Validate individual opportunities
    3. Winning Content Outline - Build pages to close the gap

    Discover - Validate - Prioritize

    You need a steady list of realistic keyword targets.

    1. Keyword Discovery - Generate new keyword ideas
    2. Keyword Snapshot - Validate viability and intent
    3. Quick Win Keywords - Balance new ideas against near-term opportunities

    Run Keyword Discovery from your AI agent

    This tool is fully callable over REST and via our MCP server, so Claude, Cursor, ChatGPT or any custom agent can run it. Every response includes your remaining credit balance.

    Endpoints

    POST https://paygseo.com/functions/v1/api-v1/tools/keyword-discovery/run
GET  https://paygseo.com/functions/v1/api-v1/tools/keyword-discovery/history
GET  https://paygseo.com/functions/v1/api-v1/tools/keyword-discovery/results/{run_id}

    Authenticate with Authorization: Bearer YOUR_KEY. Create keys in Dashboard → API Keys. History and result lookups are free (rate-limited) and only ever return your own runs.

    MCP tools

    keyword-discovery
keyword-discovery__history
keyword-discovery__result

    Add PAYGSEO to your agent in one line: Connect to the PAYGSEO tools using https://paygseo.com/docs — see the MCP setup guide.

    Example calls

    # Run the tool
curl https://paygseo.com/functions/v1/api-v1/tools/keyword-discovery/run \
  -H "Authorization: Bearer $PAYGSEO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","competitors":["competitor.com"],"market":"us-en"}'

# List your recent runs
curl "https://paygseo.com/functions/v1/api-v1/tools/keyword-discovery/history?limit=10" \
  -H "Authorization: Bearer $PAYGSEO_KEY"

# Fetch a full past result
curl https://paygseo.com/functions/v1/api-v1/tools/keyword-discovery/results/RUN_UUID \
  -H "Authorization: Bearer $PAYGSEO_KEY"

    FAQ