Get Social Volume

GET

https://api.narrativ.tech/functions/v1/youtube-timeseries-slug

Returns timeseries data of the social volume on YouTube for a specific category (number of social mentions per day / week / month related to a category).

Similar Endpoints:

https://docs.narrativ.tech/get-social-volume-23214869e0

https://docs.narrativ.tech/get-social-volume-23179161e0

Request

Authorization

Add parameter in header

api-key

Example:

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

Query Params

Responses

🟢200Success

application/json

Body

🟠400Missing Query Parameter

🟠401Unauthorized - Missing Auth Token

🟠401Unauthorized - Invalid Key

🟠404Invalid Slug

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.narrativ.tech/functions/v1/youtube-timeseries-slug?slug=rwa&start_date=2025-10-15&end_date=2025-10-22&page_limit=5&interval=day&page_offset=0' \
--header 'api-key: <api-key>'

Response Example

200 - Success - Timeseries Data

{
    "data": {
        "youtube": {
            "timeseriesData": [
                {
                    "datetime": "2025-10-18T00:00:00.000Z",
                    "value": 25
                },
                {
                    "datetime": "2025-10-19T00:00:00.000Z",
                    "value": 20
                },
                {
                    "datetime": "2025-10-20T00:00:00.000Z",
                    "value": 31
                },
                {
                    "datetime": "2025-10-21T00:00:00.000Z",
                    "value": 30
                },
                {
                    "datetime": "2025-10-22T00:00:00.000Z",
                    "value": 34
                },
                {
                    "datetime": "2025-10-23T00:00:00.000Z",
                    "value": 26
                },
                {
                    "datetime": "2025-10-24T00:00:00.000Z",
                    "value": 23
                },
                {
                    "datetime": "2025-10-25T00:00:00.000Z",
                    "value": 0
                }
            ]
        }
    },
    "pagination": {
        "total_records": 8,
        "total_pages": 1,
        "current_page": 1,
        "page_size": 10,
        "has_next_page": false,
        "has_previous_page": false
    },
    "cache": {
        "fromCache": false
    }
}

Get Channels by Country

Get Channel Hashtags