1. Keyword Vault
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 Ranking Data
    • Keyword Vault
      • Get Keyword Data by List
        GET
      • Get Overview Data
        GET
      • Get Lists
        GET
  • 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 Vault

Get Keyword Data by List

GET
/keyword-vault/v3.0/get-keyword-data-by-list
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 in a specified list within the Keyword Vault of a specified campaign. The ranking data is for the website tracked in the specified SEOmonitor campaign.

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
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 --globoff 'https://apigw.seomonitor.com/v3/keyword-vault/v3.0/get-keyword-data-by-list?campaign_id={{campaign_id}}&list={{list}}&limit={{limit}}&offset={{offset}}&order_by={{order_by}}&order_direction={{order_direction}}&search={{search}}&include_unqualified={{include_unqualified}}&domain={{domain}}' \
--header 'Accept: application/json' \
--header 'Authorization: <api-key>'

Responses

🟢200OK
application/json
Bodyapplication/json

Example
{
    "keyword": "<string>",
    "search_data": {
        "search_volume": "<integer>",
        "year_over_year": "<double>",
        "monthly_searches": {
            "search_volume": "<integer>",
            "month": "<string>",
            "year": "<integer>"
        }
    },
    "ranking_data": {
        "updated_on": "<date>",
        "rank": "<integer>",
        "trend": "<integer>",
        "landing_page": "<string>"
    },
    "serp_data": {
        "percentage_clicks": "<number>",
        "serp_features": {
            "feature": "<string>",
            "position": "<integer>"
        }
    },
    "tracked_keyword_id": "<integer>"
}
Modified at 2026-05-24 17:22:15
Previous
Get Ranking Data
Next
Get Overview Data
Built with