Get Followers Chart

Developing

GET

https://api.narrativ.tech/functions/v1/telegram/channel/followers-count

Retrieve historical subscriber count data for Telegram channel.

Returns a paginated list of data points with a date and value (follower count) at the specified interval (daily, weekly, monthly).

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

Body

🟠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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.narrativ.tech/functions/v1/telegram/channel/followers-count?handle=cointelegraph&account_id=-1001062522577&start_date&end_date&interval&page_limit&page_offset' \
--header 'api-key: <api-key>'

Response Example

200 - Success - Followers Historical data

{
    "data": [
        {
            "value": 20019,
            "datetime": "2019-08-24"
        },
        {
            "value": 21400,
            "datetime": "2019-08-25"
        }
    ]
}

Get Social Volume

Get Post Details