SEOptimer's
Rank Tracking API

Programmatically monitor where your websites — and your clients’ — rank in Google across countries and devices, and build the results into your own tools, dashboards and custom integrations.

Submit Keywords & Retrieve Rankings via JSON

Utilize JSON, the most common and simple method for API calling, to submit a URL and the keywords you want to track.

Retrieve ranking positions straight into your database, or write custom logic and alerts based on where each keyword ranks.

Track Rankings Across Countries & Devices

Check keyword positions in any supported country, on desktop or mobile.

Get results via Custom Callback or Queue-And-Wait: we call your endpoint the moment they’re ready, or you poll the request ID.

Real-Time Results, Built for Volume

Every request runs a live SERP check, so you get real search results exactly as they appear right now — not stale, cached positions.

See what a real searcher sees in each supported country, on desktop or mobile, for accurate, location-specific rankings.

Built for volume: track up to 100 keywords per request and scale your plan as your needs grow, comfortably handling peak reporting periods.

What can you do with the Rank Tracking API?

Automate Client Rank Reporting

Pull fresh keyword rankings for every client on a schedule and feed them straight into your reports and dashboards.

Integrate Rankings into your Stack

Surface live keyword positions inside your CRM, BI tool or internal dashboards where your team already works.

Track Rankings Over Time

Run regular checks to build a complete ranking history and spot improvements or drops the moment they happen.

Monitor the Competition

Track how competitor pages rank for the keywords you care about across countries and devices.

Trend Analysis & Research

Analyze ranking trends across large sets of keywords to inform content, strategy and research.

Build Rank Tracking into your SaaS

Add the power of SEOptimer's Rank Tracking API into your existing software application.

Track Rankings in 20 Countries

On both desktop and mobile

  • Australia
  • Belgium
  • Brazil
  • Canada
  • Denmark
  • France
  • Germany
  • India
  • Italy
  • Japan
  • Mexico
  • Netherlands
  • Norway
  • Poland
  • Singapore
  • South Africa
  • Spain
  • Sweden
  • United Kingdom
  • United States

Sample API Calls

Create Rank Tracking Request (without Callback)

Request
curl --location --request POST "https://api.seoptimer.com/v1/rank/create" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "x-api-key: XXXXXX" \
--data '{"url":"example.com","keywords":["your first keyword","your second keyword"],"country_code":"US","device":"mobile"}'
Response
{
    "success": true,
    "data": {
        "id": 4,
        "url": "https://example.com",
        "keywords": [
            "your first keyword",
            "your second keyword"
        ],
        "country_code": "US",
        "callback": "",
        "device": "mobile"
    }
}

Get Result

Request
curl --location --request GET "https://api.seoptimer.com/v1/rank/get/4" \
--header "Content-Type: application/json" \
--header "x-api-key: XXXXXX" \
--data ""
Response
{
    "success": true,
    "data": {
        "id": 4,
        "status": "completed",
        "input": {
            "url": "https://example.com",
            "keywords": [
                "your first keyword",
                "your second keyword"
            ],
            "country_code": "US",
            "callback": "",
            "device": "mobile"
        },
        "updated_at": "2026-07-06 17:15:24",
        "output": {
            "results": [
                {
                    "keyword": "your first keyword",
                    "position": 1,
                    "url": "https://example.com/about"
                },
                {
                    "keyword": "your second keyword",
                    "position": null,
                    "url": "https://example.com"
                }
            ]
        }
    }
}
{
    "success": true,
    "data": {
        "id": 4,
        "status": "completed",
        "input": {
            "url": "https://example.com",
            "keywords": [
                "your first keyword",
                "your second keyword"
            ],
            "country_code": "US",
            "callback": "",
            "device": "mobile"
        },
        "updated_at": "2026-07-06 17:15:24",
        "output": {
            "results": [
                {
                    "keyword": "your first keyword",
                    "position": 1,
                    "url": "https://example.com/about"
                },
                {
                    "keyword": "your second keyword",
                    "position": null,
                    "url": "https://example.com"
                }
            ]
        }
    }
}

API Specification

Send a POST request to /v1/rank/create with your API key in the x-api-key header. Request fields:

Field Required Type Default Notes
url Yes string The website URL or domain to track rankings for.
keywords Yes array or comma-separated string The keywords to check — up to 100 per request.
country_code No string (ISO 2-letter) US One of the 20 supported countries (e.g. US, GB, AU, DE).
device No string desktop Either desktop or mobile.
callback No string (URL) A webhook URL we POST the results to when the check completes.

Rank Tracking API Plans

Rank-API-1
Rank-API-2
Rank-API-3
Price
Price
$50 a Month
Price
$100 a Month
Price
$200 a Month
Keyword Rank Tracking Positions a Month
Keyword Rank Tracking Positions a Month
500
Keyword Rank Tracking Positions a Month
1500
Keyword Rank Tracking Positions a Month
5000
Submit URLs via JSON
Submit URLs via JSONSubmit URLs via JSONSubmit URLs via JSON
Retrieve Data Points via JSON
Retrieve Data Points via JSONRetrieve Data Points via JSONRetrieve Data Points via JSON
This is an advanced feature not available on trial. It will bill immediately.
This is an advanced feature not available on trial. It will bill immediately.
This is an advanced feature not available on trial. It will bill immediately.
Rank-API-1
  • Price
    $50 a Month
  • Keyword Rank Tracking Positions a Month
    500
  • Submit URLs via JSON
  • Retrieve Data Points via JSON
Rank-API-2
  • Price
    $100 a Month
  • Keyword Rank Tracking Positions a Month
    1500
  • Submit URLs via JSON
  • Retrieve Data Points via JSON
Rank-API-3
  • Price
    $200 a Month
  • Keyword Rank Tracking Positions a Month
    5000
  • Submit URLs via JSON
  • Retrieve Data Points via JSON
Rank-API-1 Annual
Rank-API-2 Annual
Rank-API-3 Annual
Price
Price
$37.50 a Month
Billed Annually at $450
Price
$75 a Month
Billed Annually at $900
Price
$150 a Month
Billed Annually at $1,800
Keyword Rank Tracking Positions a Month
Keyword Rank Tracking Positions a Month
500
Keyword Rank Tracking Positions a Month
1500
Keyword Rank Tracking Positions a Month
5000
Submit URLs via JSON
Submit URLs via JSONSubmit URLs via JSONSubmit URLs via JSON
Retrieve Data Points via JSON
Retrieve Data Points via JSONRetrieve Data Points via JSONRetrieve Data Points via JSON
This is an advanced feature not available on trial. It will bill immediately.
This is an advanced feature not available on trial. It will bill immediately.
This is an advanced feature not available on trial. It will bill immediately.
Rank-API-1 Annual
  • Price
    $37.50 a Month
    Billed Annually at $450
  • Keyword Rank Tracking Positions a Month
    500
  • Submit URLs via JSON
  • Retrieve Data Points via JSON
Rank-API-2 Annual
  • Price
    $75 a Month
    Billed Annually at $900
  • Keyword Rank Tracking Positions a Month
    1500
  • Submit URLs via JSON
  • Retrieve Data Points via JSON
Rank-API-3 Annual
  • Price
    $150 a Month
    Billed Annually at $1,800
  • Keyword Rank Tracking Positions a Month
    5000
  • Submit URLs via JSON
  • Retrieve Data Points via JSON

Use cases

Who's it for?

Digital Agencies

Track keyword rankings for every client automatically and feed live position data into your own dashboards and white label reports.

SaaS & Custom Solution Owners

Add live keyword ranking data to your own product, or build a bespoke integration on top of the Rank Tracking API.

Bloggers and Researchers

Measure how content ranks over time, spot trends and compare keyword performance across large sets of terms.

What our awesome customers are saying

FAQ

Why is SEOptimer better than the other tools?

We view a website like a real user, using a browser instead of a bot just reading code, and can see dynamic content and scripts that other tools will miss.

There is a lot more to website’s than just On-Page SEO. We look at a range of important factors that matter not just for SEO but for Usability and Accessibility.

Our PDF reports run fast – the majority of pages can be fully audited, with PDF generated within 20 seconds.

Across reports and the Embed tool you can customize Fonts, Colors, Display Layouts, Content, Checks and Sections, Report Text, Email Content.