Narrativ - Public Data API
  1. YouTube
Narrativ - Public Data API
  • Overview
  • YouTube
    • Get Channel Details
      GET
    • Get Followers Chart
      GET
    • Get Channels by Country
      GET
    • Get Social Volume
      GET
    • Get Channel Hashtags
      GET
    • Get Channel Cashtags
      GET
    • Get Trending Hashtags
      GET
    • Get Trending Cashtags
      GET
    • Get Trending Videos By Country
      GET
    • Get Video Details
      GET
    • Get Live Streamers
      GET
    • Get Video Comments
      GET
  • Telegram
    • Get Channel Details
      GET
    • Get Social Volume
      GET
    • Get Followers Chart
      GET
    • Get Post Details
      GET
    • Get Channel Cashtags
      GET
    • Get Channel Hashtags
      GET
  • X
    • Get Profile Details
      GET
    • Get Followers Chart
      GET
    • Get Social Volume
      GET
    • Get Post Details
      GET
    • Get Profile Cashtags
      GET
    • Get Profile Hashtags
      GET
    • Get Trends by Country
      GET
    • Get Top Tweets
      GET
  • Universal
  1. YouTube

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 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 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
    }
}
Previous
Get Channels by Country
Next
Get Channel Hashtags
Built with