GET streams/:id/trendline

This endpoint requires special permission to access and is only available for TV broadcast use cases. To request access please visit curator.twitter.com.

Returns tweet and author counts, and gender breakdown for a stream in minutely, hourly, or daily buckets over a time range. This is similar to metrics except that each value is list of timestamped values instead of a single value.

Resource URL

https://curator.twitter.com/broadcast/1/streams/:id/trendline

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

Example Result

{
  "start_time": 1408399380000,
  "end_time": 1408403040000,
  "data": {
    "id": 2283,
    "total": [
      {
        "timestamp": 1408399380000,
        "value": {
          "tweets": 0,
          "unique_authors": 0
        }
      },
      {
        "timestamp": 1408399440000,
        "value": {
          "tweets": 1,
          "unique_authors": 1
        }
      },
      ...
      }
    ],
    "by_gender": {
      // gender counts are rounded to nearest 100
      "male": [
        {
          "timestamp": 1408399380000,
          "value": {
            // gender counts less than 100 show up as null
            "tweets": null,
            "unique_authors": null
          }
        },
        {
          "timestamp": 1408399440000,
          "value": {
            "tweets": 100,
            "unique_authors": 100
          }
        },
        ...
      ],
      "female": [
        {
          "timestamp": 1408399380000,
          "value": {
            "tweets": null,
            "unique_authors": null
          }
        },
       ...
      ],
      "unknown": [
        {
          "timestamp": 1408399380000,
          "value": {
            "tweets": 100,
            "unique_authors": 100
          }
        },
       ...
      ]
    }
  }
}