Execute GEO analysis query

POST

/v1/open-api/geo/analysis

Executes a GEO analytics DSL query and returns normalized, structured analysis results. For detailed parameter guidance and examples, see: https://open-api-docs.dageno.ai/2055618m0

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

GEO analysis data

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dageno.ai/business/api/v1/open-api/geo/analysis' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "target": {
        "entity": "brand",
        "metrics": [
            "visibility",
            "citation"
        ],
        "filters": {
            "dateRange": {
                "startAt": "2026-03-28T00:00:00.000Z",
                "endAt": "2026-03-28T00:00:00.000Z"
            }
        }
    },
    "analysis": {
        "type": "summary",
        "ranking": {
            "orderBy": "visibility",
            "direction": "asc"
        },
        "matrix": {
            "rowDimension": "brand"
        }
    }
}'

Response Example

{
    "success": true,
    "code": 0,
    "message": "OK",
    "data": {
        "rows": [
            {
                "topic": "Mock Topic A",
                "visibility": 0.82,
                "citation": 0.41
            },
            {
                "topic": "Mock Topic B",
                "visibility": 0.73,
                "citation": 0.33
            }
        ],
        "query": {
            "target": {
                "entity": "topic",
                "metrics": [
                    "visibility",
                    "citation"
                ],
                "filters": {
                    "dateRange": {
                        "startAt": "2026-03-18T00:00:00.000Z",
                        "endAt": "2026-03-28T00:00:00.000Z"
                    }
                }
            },
            "analysis": {
                "type": "ranking",
                "ranking": {
                    "orderBy": "visibility",
                    "direction": "desc"
                }
            }
        }
    }
}

Modified at 2026-03-30 02:09:16

Get brand base information

List topics