Visits report

GET

/report/visits

Last modified:2026-10-14 15:22:20

Returns visits analytics for a date range. Range comes from start_date+end_date, or a preset. Defaults to last 30 days. Cached 30 minutes.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Header Params

Responses

🟢200

application/json

Visits report returned successfully

Bodyapplication/json

🟠400

🟠403

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/report/visits?preset=undefined&start_date=undefined&end_date=undefined' \
--header 'Accept: application/json' \
--header 'Accept-Language: {{lang}}' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "status": "success",
    "message": "Visits report returned successfully",
    "data": {
        "start_date": "2026-09-15",
        "end_date": "2026-10-14",
        "stats": {
            "visitors": 128,
            "events": 340,
            "duration": "3m 42s"
        },
        "top_pages": [
            {
                "name": "Home",
                "url": "/",
                "views": 120,
                "percent": 100
            },
            {
                "name": "Product",
                "url": "/product/some-slug",
                "views": 60,
                "percent": 50
            }
        ],
        "map_data": [
            {
                "id": "SA",
                "value": 90
            },
            {
                "id": "AE",
                "value": 12
            }
        ],
        "audience": {
            "browsers": [
                {
                    "browser": "Chrome",
                    "unique_users": 80
                }
            ],
            "devices": [
                {
                    "device_type": "mobile",
                    "unique_users": 100
                }
            ],
            "os": [
                {
                    "os": "Android",
                    "unique_users": 70
                }
            ]
        },
        "summary": "AI-generated text summary of the period"
    }
}

Modified at 2026-10-14 15:22:20

Delete Article

MediaImage