SEOmonitor API 3.0
  1. Keyword Research
SEOmonitor API 3.0
  • Overview
  • Campaigns
    • Get Tracked Campaigns
      GET
  • Rank Tracker
    • Get Keyword Data
      GET
    • Get Keyword AI Overview Data
      GET
    • Get Groups List
      GET
    • Get Keywords Competition Data
      GET
    • Get Top 100 Results
      GET
    • Get Groups Data
      GET
    • Get Daily Keyword Ranks
      GET
    • Get Daily Group Visibility
      GET
    • Add New Keywords
      POST
    • Get Keywords Import Status
      GET
    • Get Daily SERP Feature Presence
      GET
    • Get Ranking Pages
      GET
    • Get Daily Share of Clicks
      GET
  • Organic Traffic
    • Get Daily Traffic Data by Segment
      GET
    • Get Traffic Data by Keywords
      GET
  • Research
    • Keyword Research
      • By Topic
        • Get Related Keywords
        • Get Topic Overview
      • By URL/Domain
        • Get URL/Domain Overview
        • Get Ranking Keywords
      • Get Keyword Data
        GET
      • Get Ranking Data
        GET
    • Keyword Vault
      • Get Keyword Data by List
      • Get Overview Data
  • Forecast
    • Get Forecast scenarios
      GET
    • Get Forecast scenario Data
      GET
    • Get Forecast objective Data
      GET
    • Get Forecast keywords
      GET
  1. Keyword Research

Get Ranking Data

GET
https://apigw.seomonitor.com/v3/research/v3.0/ranking-data
This endpoint returns the SERP, search, and ranking data for the keywords specified in the request, for both your campaign website and the specified domains or URLs.

Request

Authorization
Add parameter in header
Authorization
Example:
Authorization: ********************
Query Params
campaign_id
integer 
required
(Required) This parameter specifies the ID of the campaign for which you want to return data.
Please refer to the Quick Start Guide to learn how to retrieve the IDs of your campaigns.
Example:
{{campaign_id}}
keywords
array[string]
required
(Required) A comma-separated list of keyword phrases that you want to return data for.
Example:
["{{keywords}}"]
domains
string 
required
(Required) A comma-separated list of domains for which you want to return the ranking data. The maximum number of domains allowed is 10.
Example:
{{domains}}
limit
integer 
optional
This parameter determines the maximum number of records to return in a single request.
Maximum Value: 1000 records per request
If you do not specify a limit, the default number of records returned per request will be 100.
Example:
{{limit}}
offset
integer 
optional
This parameter specifies the starting point within the collection of resource results. It's typically used with the limit parameter to implement pagination.
If you do not specify an offset, the API will start from the first record.
Example:
{{offset}}
order_by
string 
optional
This parameter enables you to sort the returned data based on a specified field.
The field names you can use to sort data are:
rank
rank_trend
If you do not specify an order_byparameter, the API will sort the data by rank by default.
Example:
{{order_by}}
order_direction
string 
optional
This parameter determines the sorting direction of the order_by field. You can sort the data in either ascending (asc) or descending (desc) order.
If you do not specify an order_direction, the default is asc.
Example:
{{order_direction}}
Header Params
Accept
string 
required
Example:
application/json

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://apigw.seomonitor.com/v3/research/v3.0/ranking-data?campaign_id={{campaign_id}}&keywords={{keywords}}&domains={{domains}}&limit={{limit}}&offset={{offset}}&order_by={{order_by}}&order_direction={{order_direction}}' \
--header 'Accept: application/json' \
--header 'Authorization;'

Responses

🟢200Success
application/json
Body
array of:
keyword
string 
optional
The exact keyword phrase for which the competitor website is ranking.
updated_on
string 
optional
The date when the latest crawl was performed, in YYYY-MM-DD format.
ranking_data
object 
optional
Parent field containing the Google ranking data associated with the keyword for the requested domains.
domain
string 
optional
The requested domain for which the ranking data is returned.
rank
integer 
optional
The position on Google at the latest crawl date refreshed within the past 30 days, for desktop devices.
trend
integer 
optional
The difference in positions on Google between the latest rank and the rank identified at the previous crawl, for desktop devices.
landing_page
string 
optional
The landing page of your website that is currently ranking with the keyword on Google searches performed from desktop devices.
Example
[
    {
        "keyword": "go fresco",
        "updated_on": "2023-09-06",
        "ranking_data": [
            {
                "domain": "deliveroo.co.uk",
                "rank": 45,
                "trend": 3,
                "landing_page": "https://deliveroo.co.uk/restaurants/manchester/sale"
            }
        ]
    }
]
Previous
Get Keyword Data
Next
Get Keyword Data by List
Built with