docs.x.com

# X Developer Platform

> Build, analyze, and innovate with X's real-time global data and APIs. Comprehensive documentation for the X API v2, Ads API, Enterprise APIs (Account Activity, X Activity, GNIP/PowerTrack), official SDKs, tutorials, and AI-agent tools (llms.txt, skill.md, MCP).

## Start Here

- [Overview](https://docs.x.com/overview.md): Introduction to the X Developer Platform
- [Getting Access & First Request](https://docs.x.com/make-your-first-request.md): Quickstart for new developers
- [What to Build](https://docs.x.com/what-to-build.md): Use-case ideas and inspiration
- [Developer Guidelines & Policies](https://docs.x.com/developer-guidelines.md): Rules for building responsibly
- [AI & Agent Resources](https://docs.x.com/tools/ai.md): llms.txt, skill.md, MCP, and Grok/Cursor integration

## Major Documentation Areas (Nested Indexes)

- [X API v2 — Full Index](https://docs.x.com/x-api/llms.txt): 370+ reference pages (Posts, Users, DMs, Lists, Spaces, Streams, Compliance, Webhooks, Media, etc.)
- [Enterprise APIs — Full Index](https://docs.x.com/enterprise-api/llms.txt): Account Activity, X Activity (XAA), Compliance, Chat, Communities, Direct Messages, News, Trends, Webhooks, and historical GNIP/PowerTrack
- [Ads API — Full Index](https://docs.x.com/x-ads-api/llms.txt): Campaign management, creatives, audiences, analytics, lead generation, measurement, and conversions
- [SDKs (XDKs) — Full Index](https://docs.x.com/xdks/llms.txt): Python + TypeScript/JavaScript SDK clients, models, and references
- [Python XDK Detail](https://docs.x.com/xdks/python/llms.txt) · [TypeScript XDK Detail](https://docs.x.com/xdks/typescript/llms.txt)

## Key Fundamentals & Tools

- [X API Fundamentals](https://docs.x.com/x-api/fundamentals/data-dictionary.md): Fields, expansions, pagination, versioning, consistency, rate limits
- [Authentication Guides](https://docs.x.com/fundamentals/authentication/overview.md): OAuth 1.0a, OAuth 2.0, Bearer tokens, app-only, user context
- [Tools & Libraries](https://docs.x.com/tools-and-libraries.md): Official SDKs, Postman, twurl, xurl
- [X Chat API](https://docs.x.com/xchat/introduction.md): Encrypted direct messages: guides, the Chat XDK encryption SDK, and endpoint reference
- [Changelog](https://docs.x.com/changelog.md): Platform updates and new endpoints ([RSS feed](https://docs.x.com/changelog/rss.xml))
- [Tutorials](https://docs.x.com/tutorials.md): In-depth code examples and integration guides
- [List your app on the Exhibit](https://docs.x.com/exhibit.md): Submit an X API app or agent use case to the Developer Exhibit

## For AI Agents & LLMs

- [AGENTS.md](https://docs.x.com/AGENTS.md) / [AGENT.md](https://docs.x.com/AGENT.md): Explicit instructions for AI agents on how to best use this documentation
- [llms-full.txt](https://docs.x.com/llms-full.txt): Entire documentation set as a single Markdown file (maximum context)
- [Raw Markdown for any page](https://docs.x.com/tools/llms-txt.md): Append `.md` to any docs.x.com URL
- [skill.md](https://docs.x.com/tools/skill-md.md): Structured capability summary (agentskills.io)
- [MCP Server](https://docs.x.com/tools/mcp.md): Hosted X MCP (api.x.com/mcp via xurl) + docs search MCP
- [OpenAPI Specification](https://docs.x.com/openapi.json): Machine-readable contract

All pages are also available under `/.well-known/llms.txt`. Every documentation page supports the `.md` suffix for clean Markdown retrieval by agents.