Usage - X

The Usage endpoint lets you monitor your API usage, including the number of Posts consumed. Track your usage programmatically to manage costs and stay within limits.

Pay-per-usage plans are subject to a monthly cap of 2 million Post reads. If you need higher volume, consider an Enterprise plan.

Overview

Post usage

Track Posts consumed

Daily breakdown

View usage by day

App-level

Monitor usage across your App

Endpoint

Method	Endpoint	Description
GET	`/2/usage/tweets`	Get Post usage data

Response data

The response includes daily Post consumption counts:

{
  "data": {
    "daily_project_usage": [
      {
        "date": "2024-01-15",
        "usage": [
          {
            "app_id": "12345678",
            "tweets_consumed": 15420
          }
        ]
      }
    ],
    "project_id": "1234567890",
    "project_cap": 10000000
  }
}

Fields

Field	Description
`daily_project_usage`	Array of daily usage data
`date`	Date in YYYY-MM-DD format
`app_id`	Your App’s ID
`tweets_consumed`	Posts consumed that day
`project_cap`	Your monthly Post limit

Example request

curl "https://api.x.com/2/usage/tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Use cases

Cost monitoring — Track consumption against your budget
Alerting — Set up alerts when approaching limits
Optimization — Identify high-consumption endpoints
Reporting — Generate usage reports

Resources are deduplicated within a 24-hour UTC window, so requesting the same resource multiple times in a day only counts as one charge. Learn more about pricing →

Getting started

Prerequisites

An approved developer account
A Project and App in the Developer Console
Your App’s Bearer Token

API Reference

Full endpoint documentation

Developer Console

View usage in the dashboard

Update X activity subscription

Get usage

​Overview

Post usage

Daily breakdown

App-level

​Endpoint

​Response data

​Fields

​Example request

​Use cases

​Getting started

API Reference

Developer Console

Overview

Endpoint

Response data

Fields

Example request

Use cases

Getting started