Keywords

    Keyword Snapshot

    Is this keyword worth targeting at all?

    Fast viability check for a single keyword with volume, difficulty, and intent.

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

    What it does

    Keyword Snapshot gives a quick viability check so you can avoid wasting time on low-potential terms.

    Best for

    Decide whether a keyword is worth further work.

    How it works

    1. Pull search and competition data for one keyword.
    2. Classify search intent.
    3. Return a simple decision snapshot.

    Outputs

    • Search volume
    • Difficulty score
    • CPC
    • Search intent

    Results screenshots

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

    Keyword snapshot results

    Review volume, difficulty, CPC, intent, and the go/skip decision from a completed run.

    Keyword snapshot detail view

    Open the full results view to inspect the supporting keyword metrics and context.

    Common workflows

    Validate - Plan - Publish

    You are creating a new article or landing page.

    1. Keyword Snapshot - Validate that the keyword is worth targeting
    2. Results Snapshot - See the type of content Google rewards
    3. Winning Content Outline - Build a competitive outline

    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 Snapshot 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-snapshot/run
    GET  https://paygseo.com/functions/v1/api-v1/tools/keyword-snapshot/history
    GET  https://paygseo.com/functions/v1/api-v1/tools/keyword-snapshot/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-snapshot
    keyword-snapshot__history
    keyword-snapshot__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-snapshot/run \
      -H "Authorization: Bearer $PAYGSEO_KEY" \
      -H "Content-Type: application/json" \
      -d '{"keyword":"best running shoes","market":"us-en"}'
    
    # List your recent runs
    curl "https://paygseo.com/functions/v1/api-v1/tools/keyword-snapshot/history?limit=10" \
      -H "Authorization: Bearer $PAYGSEO_KEY"
    
    # Fetch a full past result
    curl https://paygseo.com/functions/v1/api-v1/tools/keyword-snapshot/results/RUN_UUID \
      -H "Authorization: Bearer $PAYGSEO_KEY"

    FAQ