Get Lists

GET

/keyword-vault/v3.0/get-lists

Authentication required. Set the Authorization header to your SEOmonitor API token (raw JWT — no Bearer prefix). See the Authentication Guide for setup.

This endpoint allows you to retrieve all Keyword Vault lists for a particular campaign ID. The response contains the list ID and name for each non-hidden, non-deleted list belonging to the campaign.

The list IDs returned by this endpoint are stable and can be used to identify lists across other Keyword Vault endpoints. Use the list name when calling endpoints that key off the list name (such as Get Overview Data and Get Keyword Data by List).

Hidden and soft-deleted lists are excluded.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Query 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-lists?campaign_id={{campaign_id}}&limit=100&offset=undefined&search=brand' \
--header 'Authorization: <api-key>'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "lists": [
        {
            "id": 8801,
            "name": "Brand Keywords"
        },
        {
            "id": 8802,
            "name": "Camera Bodies"
        },
        {
            "id": 8803,
            "name": "Lenses"
        }
    ]
}

Modified at 2026-05-24 17:57:18

Get Overview Data

Get Forecast scenarios