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: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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": "serp data",
    "search_data": {
        "search_volume": 50,
        "year_over_year": -1.4,
        "monthly_searches": [
            {
                "month": "May",
                "year": 2026,
                "search_volume": 70
            },
            {
                "month": "June",
                "year": 2026,
                "search_volume": 30
            }
        ]
    },
    "ranking_data": {
        "updated_on": "2026-07-01",
        "rank": 100,
        "trend": 0,
        "landing_page": ""
    },
    "serp_data": {
        "percentage_clicks": 0.51,
        "serp_features": [
            {
                "feature": "ADT",
                "position": 1
            },
            {
                "feature": "QNS",
                "position": 2
            },
            {
                "feature": "VID",
                "position": 8
            },
            {
                "feature": "ADD",
                "position": 9
            },
            {
                "feature": "aio_widget",
                "position": 1
            },
            {
                "feature": "aio_has_content",
                "position": 1
            },
            {
                "feature": "KNG",
                "position": 999
            }
        ]
    },
    "tracked_keyword_id": "",
    "aio_data": {
        "rank": null,
        "trend": 0,
        "cited": false,
        "has_aio": true,
        "date": "2026-08-04"
    }
}

Modified at 2026-08-04 16:21:41

Get Overview Data

Get Lists