P
    PAYGSEO
    Rankings

    Rank Checker

    Where do I rank for these specific keywords right now?

    Checks live Google rankings for a keyword list and highlights movement over time.

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

    What it does

    Rank Checker verifies exactly where you rank right now and compares runs to show movement without guesswork.

    Best for

    Validate whether recent SEO changes had an effect.

    How it works

    1. Provide a list of keywords you care about.
    2. PAYGSEO checks live Google rankings.
    3. Results compare against previous runs to detect movement.

    Outputs

    • Keyword
    • Current rank
    • Ranking URL
    • Trend up, down, or flat

    Results screenshots

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

    Rank results

    Review current rankings, movement, and the ranking URLs from a completed check.

    Common workflows

    Find - Fix - Track

    Your site already gets traffic, but growth has stalled.

    1. Quick Win Keywords - Find keywords ranking 6-20 with traffic potential
    2. Results Snapshot - Review what page-one winners look like
    3. Page Intent & Keywords - Confirm your target URL matches intent
    4. Rank Checker - Track whether fixes move rankings

    Support - Structure - Track

    You want to expand a pillar page with supporting content.

    1. Pillar or Supporting Page? - Confirm the existing page's role
    2. Keyword Discovery - Find related supporting topics
    3. Winning Content Outline - Plan new supporting articles
    4. Rank Checker - Track movement after publishing

    Run Rank Checker 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/rank-checker/run
GET  https://paygseo.com/functions/v1/api-v1/tools/rank-checker/history
GET  https://paygseo.com/functions/v1/api-v1/tools/rank-checker/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

    rank-checker
rank-checker__history
rank-checker__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/rank-checker/run \
  -H "Authorization: Bearer $PAYGSEO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","keywords":["best running shoes","trail running shoes"],"market":"us-en"}'

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

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

    FAQ