Get Share of Voice - SEOmonitor API 3.0

This endpoint returns Share of Voice metrics for Google AI Overview (AIO) and AI Search (AIS) platforms for a specific date. The metrics are calculated using impression scores based on brand mentions and citations.

Share of Voice is calculated by:

Brand mentions: 1 point each

Brand citations: 0.5 points each

Website citations (when no brands mentioned): 1 point each

The impression score for each domain is calculated by multiplying these points by the search volume of each keyword where the domain appears.

You can use this endpoint in two ways:

to retrieve the Share of Voice data of an existing keyword group created in the SEOmonitor campaign, by specifying the group_id in the request.

to retrieve the Share of Voice data of a list of requested keywords, by specifying the list of keyword_ids in the request.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Example

{
    "total_keywords": 150,
    "total_search_volume": 2500000,
    "ai_overview_share_of_voice": {
        "date": "2024-01-15",
        "total_impression_score": 3750000,
        "domains": [
            {
                "domain": "your-website.com",
                "share_of_voice": 0.42,
                "impression_score": 1575000,
                "metrics": {
                    "brand_mentions": 45,
                    "brand_citations": 28,
                    "website_citations": 67,
                    "total_appearances": 140
                },
                "is_campaign_website": true
            },
            {
                "domain": "amazon.com",
                "share_of_voice": 0.31,
                "impression_score": 1162500,
                "metrics": {
                    "brand_mentions": 38,
                    "brand_citations": 22,
                    "website_citations": 51,
                    "total_appearances": 111
                },
                "is_campaign_website": false
            }
        ]
    },
    "ai_search_share_of_voice": {
        "date": "2024-01-15",
        "total_impression_score": 3250000,
        "domains": [
            {
                "domain": "your-website.com",
                "share_of_voice": 0.38,
                "impression_score": 1235000,
                "metrics": {
                    "brand_mentions": 32,
                    "brand_citations": 19,
                    "website_citations": 58,
                    "total_appearances": 109
                },
                "is_campaign_website": true
            },
            {
                "domain": "amazon.com",
                "share_of_voice": 0.33,
                "impression_score": 1072500,
                "metrics": {
                    "brand_mentions": 29,
                    "brand_citations": 15,
                    "website_citations": 44,
                    "total_appearances": 88
                },
                "is_campaign_website": false
            }
        ]
    }
}