Important Resources

Key documentation, tools, and community resources

Bookmark these essential resources for X API development.

---

Documentation

API Reference

Complete endpoint documentation with parameters and examples.

Data Dictionary

Object schemas for posts, users, media, and more.

Authentication

OAuth 1.0a and OAuth 2.0 implementation guides.

Rate Limits

Per-endpoint limits and best practices.

---

Tools

Tool	Description
Developer Console	Manage apps, credentials, and billing
Postman Collection	Interactive API testing
Python SDK	Official Python library
TypeScript SDK	Official TypeScript library
OpenAPI Spec	Machine-readable API specification

---

Learning

Tutorials

Step-by-step guides for common use cases.

Sample Code

Example apps and code samples.

What to Build

Ideas and inspiration for projects.

Migration Guide

Upgrade from v1.1 to v2.

---

Community & Support

Developer Forum

Ask questions and share solutions with the community.

Support Hub

FAQs, troubleshooting, and contact options.

@XDevelopers

Official updates and announcements.

@API

API-specific news and tips.

---

Stay updated

Resource	What you’ll get
Changelog	All platform changes and updates
Newsletter	Monthly roundup of news and features
Forum Announcements	Important platform notices
API Status	Real-time service availability

Follow @XDevelopers and turn on notifications to catch breaking changes and new features.

---

Quick reference

Response structure

All v2 responses follow this structure:

{
  "data": { ... },      // Primary object(s)
  "includes": { ... },  // Expanded objects (if requested)
  "meta": { ... },      // Pagination info
  "errors": [ ... ]     // Partial errors (if any)
}

Common parameters

Parameter	Use
tweet.fields	Request specific post fields
user.fields	Request specific user fields
expansions	Include related objects
max_results	Limit results per page
pagination_token	Get next/previous page

Authentication methods

Method	Use case
Bearer Token	Read-only public data
OAuth 2.0	User actions with fine-grained scopes
OAuth 1.0a	User actions (legacy, full permissions)

Full authentication guide →