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 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
    • Get Daily Group AI Search Brand Mentions visibility
      GET
    • Get Daily Group AI Search Site Citations visibility
      GET
    • Get SERP Visibility Data
      GET
  • Organic Traffic
    • Get Daily Traffic Data by Segment
    • Get Traffic Data by Keywords
  • 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
      • Get Lists
  • Forecast
    • Get Forecast scenarios
    • Get Forecast scenario Data
    • Get Forecast objective Data
    • Get Forecast keywords
  • AI Writer
    • Get Article Content
    • Generate Outlines and Articles
    • Get Generation Status
    • Get Topic Recommendations
  • Dashboard
    • List Companies (Accounts)
  • Get URL/Domain Overview
    GET
  • Get Ranking Keywords
    GET
  • Get Article Content
    GET
  • Schemas
    • Schemas
      • Root Type for campaign-visibility-timeframes
      • Root Type for campaign-details-regular
      • Root Type for group-details
      • Root Type for group-details-visibility
      • Root Type for serp-featuers-counter
      • Root Type for keyword-detail
      • Root Type for keyword-ranking-data
      • Root Type for keyword-rank-trend
      • Root Type for keyword-traffic-data
      • Root Type for keyword-landing-pages
      • Root Type for keyword-canibalization-on-date
      • Root Type for topic-keyword-detail
      • Root Type for content-landing-page-issue
      • Root Type for content_changes
      • Root Type for traffic-keywords
      • Traffic Unallocated
      • Root Type for traffic-overview
      • Root Type for campaign-visibility
      • Root Type for groups-search-data
      • Root Type for groups-serp-data
      • Root Type for groups-traffic-data
      • Root Type for keyword-daily-ranks
      • Root Type for keyword-daily-ranks-mobile-desktop
      • Root Type for daily-visibility
      • Root Type for ranking-pages
      • Root Type for analytics-data
      • Root Type for website-explorer-keywords
      • Root Type for research-serp-data
      • Root Type for research-search-data
      • Root Type for Website-explorer-overview
      • Root Type for Topics-explorer-overview
      • Root Type for research-domain-overview
      • Root Type for domain-overview-traffic
      • Root Type for domain-overview-visibility
      • Root Type for domain-rankings-data
      • Root Type for domain-ranking-keywords-data
      • Root Type for keyword-vault-get-overview-data
      • keyword-vault-get-keyword-data-by-list
      • Root Type for forecast-keyworfs
      • Root Type for forecast-scenario-data
      • Root Type for forecast-seo-goal
      • Root Type for forecast-scenario-search-data
      • Root Type for forecast-target-data
      • Root Type for forecast-configuration
      • Root Type for forecast-overview-data
      • Root Type for monthly-forecast
      • Root Type for monthly-forecast-traffic
      • Root Type for daily-share-of-clicks
      • Root Type for forecast-scenario-data
      • Root Type for forecast-objective-details
      • Root Type for objective-completion-status
      • Root Type for visibility-desktop-mobile
      • Root Type for group
      • Root Type for groups-details-keywords-counters
      • Root Type for searches-percentages-by-device
      • Root Type for opportunity
      • Root Type for keyword-traffic-ecommerce
      • Root Type for keyword-traffic-goals
      • Root Type for keyword-serp-feature
      • Root Type for keyword-canibalization-rank-data
      • Root Type for keyword-canibalization-landing-page-change
      • Root Type for keyword-competition
      • Root Type for keyword-serp-result
      • Root Type for keyword-competitor-ranking-data
      • Root Type for keywords-import-status
      • Root Type for add-keywords
      • Root Type for domain-visibility
      • Root Type for add-campaign-post-biody
      • Root Type for keywords-import-post-body
      • campaign-info
      • Root Type for keywords-import-post-body
      • Root Type for Website-explorer-keyword-domain
      • Root Type for objective
      • Root Type for search-data
      • Root Type for difficulty-value
      • Root Type for content_change
      • Ecommerce
      • Goals
      • Traffic Ecommerce
      • Traffic Goals
      • Root Type for keyword-serp-feaftures
      • Root Type for sesonality-trend
      • Root Type for best_rank
      • Root Type for landing-pages
      • Root Type for top-results
      • Root Type for top-100-results
      • Root Type for group_keyword_counters
      • groups-opportunity
      • Root Type for groups-volume-by-device
      • Root Type for groups-search-intent
      • Root Type for groups-desktop-mobile-visibility
      • Root Type for groups-mobile-visibility
      • Root Type for groups-serp-mobile-desktop
      • Root Type for keyword-daily-rank
      • Root Type for groups-visibility
      • Root Type for groups-avg-rank
      • Root Type for groups-feature-visibility
      • Root Type for ranking-keywords
      • Root Type for serp-feature-presence
      • Root Type for serp-feature-presence-by-device
      • Root Type for serp-feature-presence-mobile-desktop
      • Root Type for gsc-data
      • Root Type for research-ranking-data
      • Root Type for research-serp-feature
      • Root Type for research-domain-ranking
      • Root Type for topic-overview-serp
      • Root Type for topic-overview-serp-feature
      • Root Type for topic-overview-visibility
      • Root Type for overview-traffic-data
      • Root Type for domain-competitor-visibility
      • Root Type for domain-competitor-rank
      • Root Type for forecast-keyword-data
      • Root Type for forecast-keyword-avg-rank
      • Root Type for forecast-keyword-additional-traffic
      • Root Type for forecast-target-avg-rank
      • Root Type for forecast-target-avg-visibility
      • Root Type for forecast-config-conversion-data
      • Root Type for forecast-additional-traffic
      • Root Type for forecast-overview-inertial-traffic
      • Root Type for forecast-ads-equivalent
      • Root Type for forecast-
      • Root Type for forecast-traffic-revenue
      • Root Type for forecast-traffic-visibility
      • Root Type for forecast-traffic-estimated_avg_ranks
      • Root Type for Scenarios
      • Root Type for monthly-forecast-traffic-sessions
      • Root Type for share-of-clicks-domains
      • Root Type for completion-status-30days
      • Root Type for completion-status-date-sessions
    • RequestBodies
      • Body
    • SerpVisibilityResponse
    • SerpVisibilityDataItem
    • SerpVisibilityMeta
    • ErrorResponse
  1. Keyword Research

Get Ranking Data

GET
/research/v3.0/ranking-data
Authentication required. Set the Authorization header to your SEOmonitor API token (raw JWT — no Bearer prefix). See the Authentication Guide for setup.
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
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Query 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 --globoff '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 'Authorization: <api-key>'

Responses

🟢200OK
application/json
Bodyapplication/json

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"
        }
    ]
}
Modified at 2026-05-24 17:22:15
Previous
Get Keyword Data
Next
Get Keyword Data by List
Built with