Usage

Monitor your API usage and track Post consumption

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.

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 plan limits
• 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