Get Followers Chart

GET

https://api.narrativ.tech/functions/v1/x-followers

Returns a time series of follower counts for an X (Twitter) account over a given date range. Data is aggregated into daily, weekly, or monthly buckets. Optionally includes period-over-period growth percentage.

Ideal for rendering line charts showing follower growth over time.

Notes:

If start_date, end_date, and interval are all omitted, the endpoint returns daily data for the last 6 months.

If end_date is omitted, it defaults to today.

If end_date is provided, start_date is required.

If the requested interval is too coarse for the date range (e.g., month for a 2-week period), the system automatically downgrades to the smallest supported interval (day)

Request

Authorization

Add parameter in header

api-key

Example:

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

Query Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400Wrong Params - Start Date after End date

🟠400Wrong Params - End date before Start date

🟠400Wrong Params - Missing Start date

🟠400Wrong Params - Missing Identifier

🟠401Unauthorized - Missing Auth Token

🟠401Unauthorized - Invalid Key

🟠404Invalid Identifier

🟠400Wrong Params - Invalid Interval

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.narrativ.tech/functions/v1/x-followers?handle=MrBeast&account_id=&start_date=undefined&end_date=undefined&interval=undefined&page_size=undefined&page_offset=undefined&show_growth=undefined' \
--header 'api-key: <api-key>'

Response Example

200 - Success - Followers Historical data

{
    "data": [
        {
            "date": "2025-12-31",
            "value": 52519
        },
        {
            "date": "2025-12-30",
            "value": 52523
        },
        {
            "date": "2025-12-29",
            "value": 52529
        },
        {
            "date": "2025-12-28",
            "value": 52528
        },
        {
            "date": "2025-12-27",
            "value": 52535
        }
    ],
    "pagination": {
        "totalRecords": 223,
        "totalPages": 9,
        "currentPage": 1,
        "pageSize": 25,
        "hasNextPage": true,
        "hasPreviousPage": false
    }
}

Get Profile Details

Get Social Volume