Get Keyword Data - SEOmonitor API 3.0

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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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
                }
            ]
        }
    }
]