Collection Geo Distribution

Developing

GET

/libraries/{libraryID}/collections/{collectionId}/analytics/{analyticsType}

Provides Collection Geo distribution of a library
📣 this endpoint provides geo distribution of a collection in library

✳ list of request query parameters

start_time

end_time

group_by = geo_region

🔰 this endpoint gives total geo distributed usage of contents of the contents of a collection in a library

📢 Info message : Here URL is contructed like
GET

/libraries/<library_id>/collections/<collection_id>/analytics/geo-distribution?start_time=<time>&end_time=<time>&group_by=geo_region

here time should be formated in RFC3339

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

Body

🟢200OK

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api-staging.tenbyte.io/v1/libraries//collections/c2ffaea1-c967-4672-b5bc-789144d58b3d/analytics/geo-distribution?start_time=2024-02-24T17:59:59.999Z&end_time=2024-03-02T17:59:59.999Z&group_by=geo_region' \
--header 'Authorization: Bearer <token>'

Response Example

200 - OK - Example 1

{
    "message": "string",
    "result": {
        "message": "string",
        "result": {
            "filters": [
                {
                    "field": "string",
                    "operator": "string",
                    "values": [
                        "string"
                    ]
                }
            ],
            "group_bys": [
                "string"
            ],
            "metrics": [
                {
                    "data": [
                        {
                            "media_series": "string",
                            "total_media_views": 0
                        }
                    ],
                    "filters": null,
                    "group_bys": [
                        "string"
                    ],
                    "name": "string"
                }
            ]
        }
    },
    "success": true
}

Modified at 2025-07-16 07:39:43

Library Collections insights

Collection avg watch time