Get Social Volume

GET

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

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

Request

Authorization

Add parameter in header

api-key

Example:

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

Query Params

Responses

🟢200Success

application/json

Body

🟠400Missing Query Parameter

🟠401Unauthorized - Invalid Key

🟠401Unauthorized - Missing Auth Token

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.narrativ.tech/functions/v1/x-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": {
        "x": {
            "timeseriesData": [
                {
                    "datetime": "2024-01-01T00:00:00.000Z",
                    "value": 68500
                },
                {
                    "datetime": "2024-01-02T00:00:00.000Z",
                    "value": 97599
                },
                {
                    "datetime": "2024-01-03T00:00:00.000Z",
                    "value": 100100
                },
                {
                    "datetime": "2024-01-04T00:00:00.000Z",
                    "value": 93794
                },
                {
                    "datetime": "2024-01-05T00:00:00.000Z",
                    "value": 99360
                }
            ]
        }
    },
    "pagination": {
        "total_records": 640,
        "total_pages": 128,
        "current_page": 1,
        "page_size": 5,
        "has_next_page": true,
        "has_previous_page": false
    },
    "cache": {
        "fromCache": true,
        "cachedAt": "2025-10-22T02:00:11.032Z",
        "cacheDateRange": {
            "startDate": "2023-07-01",
            "endDate": "2025-10-22"
        }
    }
}

Get Followers Chart

Get Post Details