Get market metrics

GET

/projects/{projectId}/market/metrics

Returns market brand rankings, trends, and platform, region or intent breakdowns. Brand rankings include Top N brands plus the own brand and configured competitors. Date groupings return the complete series in ascending order; limit does not truncate it. Results exceeding limits.maxMetricRows return 400. Queries without a brand grouping accept only one brand. With groupBy=brand alone and no brandIds, limit controls the Top N count up to marketTopN, with the own brand and configured competitors added.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Success. Example values are illustrative.

Headers

Bodyapplication/json

🟠400Error400

🟠401Error401

🟠403Error403

🟠404Error404

🟠409Error409

🟠429Error429

🔴500Error500

🔴503Error503

🔴504Error504

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.dageno.ai/llm-data-service/api/v1/llm-data/public/projects//market/metrics?categoryId=&startDate=&endDate=&groupBy=&brandIds=&platforms=&regions=&intentIds=&limit=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "data": [
        {
            "dimensions": {
                "brand": {
                    "entityId": "22222222-2222-4222-8222-222222222222",
                    "name": "Example Brand",
                    "isOwn": true,
                    "isConfigured": false,
                    "rank": 6,
                    "inTopN": true
                }
            },
            "metrics": {
                "visibility": 0.19,
                "mentionResponseCount": 190,
                "responseCount": 1000,
                "avgPosition": 4.2,
                "rankedResponseCount": 150,
                "validDays": 28
            }
        }
    ],
    "meta": {
        "requestId": "req_example",
        "generatedAt": "2026-11-03T08:00:00Z",
        "timezone": "UTC",
        "requestedRange": {
            "startDate": "2026-10-01",
            "endDate": "2026-10-28"
        },
        "effectiveRange": {
            "startDate": "2026-10-01",
            "endDate": "2026-10-28"
        },
        "validDays": 28,
        "dataAsOf": null,
        "metricVersion": "market-2026-11",
        "population": "market_category",
        "aggregation": "period_distinct",
        "truncated": false,
        "limit": 50,
        "scopeVersion": "sv_3f2a",
        "quality": "unknown"
    }
}

Modified at 2026-11-04 09:56:08

List authorized markets

Get market citations