SEOmonitor API 3.0
  1. Rank Tracker
SEOmonitor API 3.0
  • Overview
  • Campaigns
    • Get Tracked Campaigns
      GET
  • Rank Tracker
    • Get Keyword Data
      GET
    • Get Keyword AI Overview Data
      GET
    • Get Keyword AI Search Data
      GET
    • Get Groups List
      GET
    • Get Keywords Competition Data
      GET
    • Get Keywords Competition Data AI Overview
      GET
    • Get Keywords Competition AI Search Data
      GET
    • Get Top 100 Results
      GET
    • Get Groups Data
      GET
    • Get Daily Keyword Ranks
      GET
    • Get Daily Keyword Ranks AI Overview
      GET
    • Get Daily AI Search Keyword Ranks
      GET
    • Get Daily Group Visibility
      GET
    • Get Daily Group Visibility AI Overview Mentions
      GET
    • Get Daily Group Visibility AI Overview Citations
      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
    • Get Share of Voice
      GET
  • Organic Traffic
    • Get Daily Traffic Data by Segment
      GET
    • Get Traffic Data by Keywords
      GET
    • Get Daily Traffic Data by Segment
      GET
    • Get Traffic Data by Keywords
      GET
  • Research
    • Keyword Research
      • By Topic
        • Get Related Keywords
        • Get Topic Overview
        • Get Related Keywords
        • Get Topic Overview
      • By URL
        • Domain
          • Get URL/Domain Overview
          • Get Ranking Keywords
      • Get Keyword Data
      • Get Ranking Data
      • Get Keyword Data
      • Get Ranking Data
    • Keyword Vault
      • Get Keyword Data by List
      • Get Overview Data
      • Get Keyword Data by List
      • Get Overview Data
  • Forecast
    • Get Forecast scenarios
    • Get Forecast scenario Data
    • Get Forecast objective Data
    • Get Forecast keywords
    • Get Forecast scenarios
    • Get Forecast scenario Data
    • Get Forecast objective Data
    • Get Forecast keywords
  • AI Writer
    • Generate Outlines and Articles
    • Get Generation Status
    • Get Article Content
    • Get Topic Recommendations
  • Get URL/Domain Overview
    GET
  • Get Ranking Keywords
    GET
  1. Rank Tracker

Get Keyword Data

GET
/rank-tracker/v3.0/keywords
This endpoint retrieves active keywords and their corresponding data within a specified timeframe from the Rank Tracker.
With this endpoint, you can get:
Campaign-wide Data: By default, this endpoint returns data for all active keywords in a specified campaign.
Group-specific Data: When you provide a group_id, this endpoint will return data exclusively for the keywords within the specified group. Additionally, there are special group IDs which can access predefined groups. These are detailed further in the section on query parameters.
Keyword-specific Data: You can request data for specific keywords within a campaign by supplying their IDs using the keyword_ids parameter. keyword_ids should be a comma-separated list of keyword IDs.
Note: Use other parameters like limit, offset, order_by, order_direction, and search to further customize the data retrieval as per your needs.

Request

Query Params

Header Params

Request Code 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/rank-tracker/v3.0/keywords?campaign_id={{campaign_id}}&start_date={{start_date}}&end_date={{end_date}}&group_id={{group_id}}&include_all_groups={{include_all_groups}}&keyword_ids={{keyword_ids}}&limit={{limit}}&offset={{offset}}&order_by={{order_by}}&order_direction={{order_direction}}&search={{search}}' \
--header 'Accept: application/json'

Responses

🟢200OK
application/json
Body

Example
[
    {
        "keyword_id": 7882029,
        "keyword": "victoria secret",
        "groups": "123,123443",
        "labels": "in_season, label1, low relevance",
        "search_intent": "transactional",
        "search_data": {
            "search_volume": 90500,
            "year_over_year": 1.49,
            "monthly_searches": [
                {
                    "month": "March",
                    "year": "2023",
                    "search_volume": 49500
                }
            ]
        },
        "percentage_clicks": 77,
        "ranking_data": {
            "desktop": {
                "rank": 100,
                "trend": 0,
                "trend_impact": 23100,
                "best_rank": {
                    "rank": 2,
                    "date": "2023-08-01"
                }
            },
            "mobile": {
                "rank": 100,
                "trend": 0,
                "trend_impact": 23100,
                "best_rank": {
                    "rank": 2,
                    "date": "2023-08-01"
                }
            }
        },
        "ai_overview": {
            "desktop": {
                "my_brand_present": false,
                "any_brand_present": true,
                "rank": 20,
                "previous_rank": 20,
                "trend": 0,
                "processing": false
            },
            "mobile": {
                "my_brand_present": false,
                "any_brand_present": true,
                "rank": 20,
                "previous_rank": 20,
                "trend": 0,
                "processing": false
            }
        },
        "traffic_data": {
            "sessions": 0,
            "ecommerce": {
                "transactions": 0,
                "revenue": 0
            },
            "goals": {
                "completions": 0,
                "revenue": 0
            }
        },
        "opportunity": {
            "score": 8,
            "difficulty_top_10": "hard",
            "additional_monthly_sessions": 18744,
            "avg_cpc": 0.06
        },
        "ai_search": {
            "rank": 100,
            "trend": -89,
            "any_brand_present": true,
            "my_brand_present": true,
            "sentiment_of_my_brand": "positive"
        },
        "landing_pages": {
            "desktop": {
                "current": "https://www.elefant.ro/list/parfumuri/filters/brand-Victoria%2527s%2BSecret",
                "desired": "https://www.elefant.ro/list/parfumuri/filters/brand-Victoria%2527s%2BSecret"
            },
            "mobile": {
                "current": "https://www.elefant.ro/list/parfumuri/filters/brand-Victoria%2527s%2BSecret",
                "desired": "https://www.elefant.ro/list/parfumuri/filters/brand-Victoria%2527s%2BSecret"
            }
        },
        "serp_data": {
            "desktop": [
                {
                    "feature": "AIO",
                    "position": "1",
                    "listed": true
                },
                {
                    "feature": "AIB",
                    "position": "2",
                    "listed": false
                },
                {
                    "feature": "KG",
                    "position": "side",
                    "listed": false
                }
            ],
            "mobile": [
                {
                    "feature": "AIO",
                    "position": "1",
                    "listed": true
                },
                {
                    "feature": "AIB",
                    "position": "2",
                    "listed": false
                },
                {
                    "feature": "KG",
                    "position": "1",
                    "listed": false
                }
            ]
        }
    }
]
Modified at 2025-10-23 13:35:01
Previous
Get Tracked Campaigns
Next
Get Keyword AI Overview Data
Built with