---
title: "Returns the follows/unfollows-per-post timeline for X (Twitter): one point per published post with the follows and unfollows it generated."
method: GET
path: "/v2/analytics/posts/twitter/follows-unfollows/timeline"
tags: ["Twitter Analytics Api Service"]
---

# Returns the follows/unfollows-per-post timeline for X (Twitter): one point per published post with the follows and unfollows it generated.

`GET /v2/analytics/posts/twitter/follows-unfollows/timeline`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/analytics/posts/twitter/follows-unfollows/timeline`
- Auth: none declared

## Query parameters

- `from` string, required
- `to` string, required
- `timezone` string

## Response `200`

OK

- JsonOkListResponseTwitterFollowsPerPostPoint
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` TwitterFollowsPerPostPoint[]
    - `tweetId` string: Tweet ID of the published post
    - `date` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `follows` integer: Follows generated by this post
    - `unfollows` integer: Unfollows generated by this post

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/cd0ca612fa01?raw)