X (Twitter)

X (formerly Twitter) is a social media platform providing APIs for accessing and integrating with posts, users, spaces, direct messages, lists, media, trends, and real-time streaming data. The X API enables developers to build applications that read and write X data, manage advertising campaigns, and subscribe to real-time activity events. Available through pay-per-use credit-based pricing with enterprise options for high-volume access.

X (Twitter) publishes 22 APIs on the APIs.io network, including X Ads API, Account Activity API, Activity API, and 19 more. Tagged areas include Social Media, Microblogging, Real-Time Data, Streaming, and Advertising.

The X (Twitter) catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

X (Twitter)’s developer surface includes authentication, developer portal, getting-started guide, developer console, signup flow, CLI, pricing, and 45 more developer resources.

🌐 Visit website 📡 Source on GitHub

63.9/100 strong ▬ flat Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessPaidSelf serve

23 APIs 12 Features 8 Use Cases

Social MediaMicrobloggingReal-Time DataStreamingAdvertisingContent

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 63.9/100 · strong

Contract Quality 16.3 / 25

Developer Ergonomics 12.2 / 20

Commercial Clarity 12.1 / 20

Operational Transparency 8.9 / 13

Governance 7.0 / 12

Discoverability 7.4 / 10

Agent readiness — 37/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/twitter: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 23

Individual APIs this provider publishes, each with its own machine-readable definition.

X Ads API

The X Ads API enables programmatic management of advertising campaigns on the X platform including campaign creation and scheduling, custom audience building, creative managemen...

X Activity API

The X Activity API provides real-time activity event subscriptions with sub-second delivery via streaming or webhooks. Subscribe to profile updates, follows, likes, reposts, and...

X (Twitter) Account Activity API

Endpoints relating to retrieving, managing AAA subscriptions

X (Twitter) Activity API

The Activity API from X (Twitter) — 3 operation(s) for activity.

X (Twitter) Bookmarks API

Endpoints related to retrieving, managing bookmarks of a user

X (Twitter) Chat API

The Chat API from X (Twitter) — 15 operation(s) for chat.

X (Twitter) Communities API

The Communities API from X (Twitter) — 2 operation(s) for communities.

X (Twitter) Community Notes API

The Community Notes API from X (Twitter) — 5 operation(s) for community notes.

X (Twitter) Compliance API

Endpoints related to keeping X data in your systems compliant

X (Twitter) Connections API

Endpoints related to streaming connections

X (Twitter) Direct Messages API

Endpoints related to retrieving, managing Direct Messages

X (Twitter) General API

Miscellaneous endpoints for general API functionality

X (Twitter) Likes API

The Likes API from X (Twitter) — 2 operation(s) for likes.

X (Twitter) Lists API

Endpoints related to retrieving, managing Lists

X (Twitter) Media API

Endpoints related to Media

X (Twitter) News API

Endpoint for retrieving news stories

X (Twitter) Spaces API

Endpoints related to retrieving, managing Spaces

X (Twitter) Stream API

Endpoints related to streaming

X (Twitter) Trends API

The Trends API from X (Twitter) — 2 operation(s) for trends.

X (Twitter) Tweets API

Endpoints related to retrieving, searching, and modifying Tweets

X (Twitter) Usage API

The Usage API from X (Twitter) — 1 operation(s) for usage.

X (Twitter) Users API

Endpoints related to retrieving, managing relationships of Users

X (Twitter) Webhooks API

The Webhooks API from X (Twitter) — 5 operation(s) for webhooks.

Scroll for all 23

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

X API v2

POSTMAN

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

X API v2

OPEN COLLECTION

Arazzo Workflows 19

Multi-step API workflows described with the Arazzo specification.

X Search, Bookmark a Post, Then Remove the Bookmark

Find a post by search, bookmark it, then delete that bookmark.

ARAZZO

X Create a List and Add a Member by Username

Create a new List, resolve a member handle, and add them to the List.

ARAZZO

X Confirm a List and Follow It

Read a List by id to confirm it exists, then follow that List.

ARAZZO

X Follow a User by Their Username

Resolve a target handle to an id, then follow that user.

ARAZZO

X List the Followers of a Handle

Resolve a username to an id, then page that user's followers.

ARAZZO

X List the Posts a Handle Has Liked

Resolve a username to an id, then fetch that user's liked posts.

ARAZZO

X Fetch a List's Details and Its Members

Read a List by id, then page the members of that List.

ARAZZO

X List the Posts Mentioning a Handle

Resolve a username to an id, then fetch posts that mention that user.

ARAZZO

X Mute a User by Their Username

Resolve a target handle to an id, then mute that user.

ARAZZO

X Pin the Authenticated User's First Owned List

List the owned Lists, then pin the first one to the user's profile.

ARAZZO

X Audit Engagement on a User's Latest Post

Resolve a handle, get their latest post, then list who liked it.

ARAZZO

X Create a Post, Like It, Then Delete It

Publish a post, like it from the authenticated account, then remove it.

ARAZZO

X Quote a Post Found by Search

Search recent posts, then publish a quote post of the top match.

ARAZZO

X Reply to a User's Latest Post

Resolve a handle, fetch their latest post, then reply to it.

ARAZZO

X Find a Post, Repost It, Then Undo the Repost

Search for a post, repost the top match, then remove the repost.

ARAZZO

X List Who Reposted a Handle's Latest Post

Resolve a handle, get their latest post, then list who reposted it.

ARAZZO

X Search Recent Posts and Hydrate the Top Match

Run a recent search, then fetch full details for the first matching post.

ARAZZO

X Unfollow a User by Their Username

Resolve a target handle to an id, then unfollow that user.

ARAZZO

X Resolve User and List Their Recent Posts

Look up a user by username, then pull their most recent posts.

ARAZZO

Scroll for all 19

GraphQL 1

GraphQL schemas published by this provider.

Twitter (X) GraphQL Schema

This conceptual GraphQL schema models the Twitter (X) API v2 data model. The X API v2 is a REST API available at `https://api.x.com/2`, but the types defined here represent the ...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Twitter Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Twitter Rate Limits

13 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Twitter Finops

FINOPS

Features 12

Notable capabilities this provider offers.

Post Management

Create, delete, edit, repost, quote, like, and bookmark posts programmatically.

Real-Time Streaming

Access filtered streams, sampled streams, firehose, and language-specific streams for real-time post data.

Full-Archive Search

Search the complete archive of public posts with advanced query operators and date filtering.

User Lookup and Management

Look up users by ID or username, manage follows, blocks, mutes, and retrieve user metrics.

Spaces

Discover and look up live audio Spaces with host, speaker, and listener data.

Direct Messages

Send and receive direct messages, create conversations, and manage participants.

Lists

Create, manage, and query lists including membership, followers, and pinned lists.

Trends

Access personalized and geographic trending topics.

Media Upload

Upload images, videos, and large files using chunked upload with metadata and subtitle support.

Compliance

Access compliance streams and batch jobs for data deletion and user protection events.

Communities and Community Notes

Access community data and community notes for collaborative fact-checking.

Ad Campaign Management

Programmatically create, schedule, and manage advertising campaigns with targeting and budget controls.

Scroll for all 12

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

X Api Context

23 classes · 118 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

X (Twitter) API Rules

5 rules · 4 warnings 1 info

SPECTRAL

X (Twitter) API Rules

54 rules · 17 errors 19 warnings 18 info

SPECTRAL

JSON Schema 25

Standalone JSON Schema definitions for this provider's data models.

ActivityStreamingResponse

2 properties

JSON SCHEMA

ActivitySubscription

7 properties

JSON SCHEMA

AddOrDeleteRulesRequest

0 properties

JSON SCHEMA

ComplianceJob

9 properties

JSON SCHEMA

ComplianceJobStatus

0 properties

JSON SCHEMA

CreateDmConversationRequest

3 properties

JSON SCHEMA

DmEvent

13 properties

JSON SCHEMA

Error

2 properties

JSON SCHEMA

Expansions

6 properties

JSON SCHEMA

FilteredStreamingTweetResponse

4 properties

JSON SCHEMA

Get2TweetsSearchRecentResponse

4 properties

JSON SCHEMA

Get2UsersIdResponse

3 properties

JSON SCHEMA

ListCreateRequest

3 properties

JSON SCHEMA

List

8 properties

JSON SCHEMA

Media

4 properties

JSON SCHEMA

Place

8 properties

JSON SCHEMA

Poll

5 properties

JSON SCHEMA

Problem

4 properties

JSON SCHEMA

Space

17 properties

JSON SCHEMA

TweetCreateRequest

16 properties

JSON SCHEMA

TweetCreateResponse

2 properties

JSON SCHEMA

TweetDeleteResponse

2 properties

JSON SCHEMA

29 properties

JSON SCHEMA

User

21 properties

JSON SCHEMA

UsersFollowingCreateRequest

1 properties

JSON SCHEMA

Scroll for all 25

JSON Structure 25

JSON Structure definitions describing this provider's data shapes.

X Api Activity Streaming Response Structure

2 properties

JSON STRUCTURE

X Api Activity Subscription Structure

7 properties

JSON STRUCTURE

X Api Add Or Delete Rules Request Structure

0 properties

JSON STRUCTURE

X Api Compliance Job Status Structure

0 properties

JSON STRUCTURE

X Api Compliance Job Structure

9 properties

JSON STRUCTURE

X Api Create Dm Conversation Request Structure

3 properties

JSON STRUCTURE

X Api Dm Event Structure

13 properties

JSON STRUCTURE

X Api Error Structure

2 properties

JSON STRUCTURE

X Api Expansions Structure

6 properties

JSON STRUCTURE

X Api Filtered Streaming Tweet Response Structure

4 properties

JSON STRUCTURE

X Api Get2 Tweets Search Recent Response Structure

4 properties

JSON STRUCTURE

X Api Get2 Users Id Response Structure

3 properties

JSON STRUCTURE

X Api List Create Request Structure

3 properties

JSON STRUCTURE

X Api List Structure

8 properties

JSON STRUCTURE

X Api Media Structure

4 properties

JSON STRUCTURE

X Api Place Structure

8 properties

JSON STRUCTURE

X Api Poll Structure

5 properties

JSON STRUCTURE

X Api Problem Structure

4 properties

JSON STRUCTURE

X Api Space Structure

17 properties

JSON STRUCTURE

X Api Tweet Create Request Structure

16 properties

JSON STRUCTURE

X Api Tweet Create Response Structure

2 properties

JSON STRUCTURE

X Api Tweet Delete Response Structure

2 properties

JSON STRUCTURE

X Api Tweet Structure

29 properties

JSON STRUCTURE

X Api User Structure

21 properties

JSON STRUCTURE

X Api Users Following Create Request Structure

1 properties

JSON STRUCTURE

Scroll for all 25

Examples 23

Example request and response payloads for these APIs.

X Api Activity Streaming Response Example

2 fields

EXAMPLE

X Api Activity Subscription Example

7 fields

EXAMPLE

X Api Compliance Job Example

9 fields

EXAMPLE

X Api Create Dm Conversation Request Example

3 fields

EXAMPLE

X Api Dm Event Example

10 fields

EXAMPLE

X Api Error Example

2 fields

EXAMPLE

X Api Expansions Example

6 fields

EXAMPLE

X Api Filtered Streaming Tweet Response Example

4 fields

EXAMPLE

X Api Get2 Tweets Search Recent Response Example

4 fields

EXAMPLE

X Api Get2 Users Id Response Example

3 fields

EXAMPLE

X Api List Create Request Example

3 fields

EXAMPLE

X Api List Example

8 fields

EXAMPLE

X Api Media Example

4 fields

EXAMPLE

X Api Place Example

8 fields

EXAMPLE

X Api Poll Example

5 fields

EXAMPLE

X Api Problem Example

4 fields

EXAMPLE

X Api Space Example

10 fields

EXAMPLE

X Api Tweet Create Request Example

10 fields

EXAMPLE

X Api Tweet Create Response Example

2 fields

EXAMPLE

X Api Tweet Delete Response Example

2 fields

EXAMPLE

X Api Tweet Example

10 fields

EXAMPLE

X Api User Example

10 fields

EXAMPLE

X Api Users Following Create Request Example

1 fields

EXAMPLE

Scroll for all 23

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Twitter Authentication

http/oauth2 · 3 schemes

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Twitter Scopes

21 scopes · authorizationCode

21 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Twitter Agentic Access

163 operations · 67 acting · 3 human-in-the-loop

163 operations · 67 acting

AGENTIC

Use Cases 8

What developers build with this provider.

Social Listening

Monitor brand mentions, sentiment, and conversations in real-time using filtered streams and search endpoints.

Content Publishing

Automate post creation, scheduling, and thread publishing for social media management platforms.

Analytics and Reporting

Retrieve post metrics, user engagement data, and campaign performance for business intelligence.

Bot Development

Build automated accounts that respond to mentions, post updates, or provide customer service.

Research and Academic Analysis

Access full-archive search and streaming data for social media research and trend analysis.

Advertising Automation

Programmatically manage ad campaigns, audiences, creatives, and bidding strategies at scale.

Real-Time Event Monitoring

Track live events, breaking news, and trending topics with streaming APIs and trend endpoints.

Community Management

Manage followers, lists, and direct messages for community engagement and moderation.

Scroll for all 8

Integrations 3

Pre-built integrations with other platforms and tools.

Postman

Official Postman collections for exploring and testing X API endpoints interactively.

MCP Servers

Integration with AI tools and agents through Model Context Protocol servers.

Webhook Delivery

Real-time event delivery via webhooks for the Activity API.

Solutions 3

Packaged solutions this provider offers.

X API Pay-Per-Use

Credit-based pricing with no commitments. Pay only for what you use with access to core X API endpoints.

X API Enterprise

High-volume access with custom rate limits, dedicated account management, full firehose, and premium support.

X Ads API

Advertising platform API for campaign management, audience targeting, creative management, and analytics.

Resources

Get Started 5

Portal, sign-up, and the first successful call

Portal

GettingStarted

Console

Signup

Sandbox

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 19

Pagination, idempotency, versioning, errors, and events

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Scroll for all 19

Build 15

SDKs, sample code, and the tooling you integrate with

Python XDK

SDKs

TypeScript XDK

SDKs

xurl

CLI

GitHubOrganization

GitHubRepository

GitHubRepository

GitHubRepository

GitHubRepository

GitHubRepository

GitHubRepository

Tools

CodeExamples

CodeExamples

PostmanWorkspace

PostmanCollection

PostmanCollection

Scroll for all 15

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

Authentication

Authentication

Operate 3

Status, limits, changes, and where to get help

StatusPage

StatusPage

Support

Support

ReleaseNotes

ReleaseNotes

Commercial 3

Pricing, plans, and the legal terms of use

Pricing

Pricing

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 2

The organization behind the API

LinkedIn

Blog

Blog

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

aid: twitter
name: X (Twitter)
description: X (formerly Twitter) is a social media platform providing APIs for accessing and integrating with posts, users,
  spaces, direct messages, lists, media, trends, and real-time streaming data. The X API enables developers to build applications
  that read and write X data, manage advertising campaigns, and subscribe to real-time activity events. Available through
  pay-per-use credit-based pricing with enterprise options for high-volume access.
type: Index
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://abs.twimg.com/favicons/twitter.ico
url: https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/apis.yml
created: '2025-07-29'
modified: '2026-05-19'
specificationVersion: '0.19'
tags:
- Social Media
- Microblogging
- Real-Time Data
- Streaming
- Advertising
- Content
apis:
- aid: twitter:x-ads-api
  name: X Ads API
  description: The X Ads API enables programmatic management of advertising campaigns on the X platform including campaign
    creation and scheduling, custom audience building, creative management (draft posts, cards, media), and analytics retrieval
    for campaign performance metrics. Supports both synchronous and asynchronous analytics endpoints for reporting.
  image: https://abs.twimg.com/favicons/twitter.ico
  humanURL: https://docs.x.com/x-ads-api
  baseURL: https://ads-api.x.com
  properties:
  - type: Documentation
    url: https://docs.x.com/x-ads-api
  - type: GettingStarted
    url: https://docs.x.com/x-ads-api/getting-started/create-a-campaign
  - type: RateLimits
    url: https://docs.x.com/x-ads-api/fundamentals/rate-limiting
  - type: PostmanCollection
    url: postman/x-ads-api-postman-collection.json
  tags:
  - Advertising
  - Campaigns
  - Analytics
  - Audiences
  - Creatives
- aid: twitter:x-activity-api
  name: X Activity API
  description: The X Activity API provides real-time activity event subscriptions with sub-second delivery via streaming or
    webhooks. Subscribe to profile updates, follows, likes, reposts, and other user activity events. Recently exited beta
    and is now generally available.
  image: https://abs.twimg.com/favicons/twitter.ico
  humanURL: https://docs.x.com/x-activity-api
  baseURL: https://api.x.com
  properties:
  - type: Documentation
    url: https://docs.x.com/x-activity-api
  tags:
  - Activity
  - Events
  - Real-Time
  - Streaming
  - Webhooks
- aid: twitter:twitter-account-activity-api
  name: X (Twitter) Account Activity API
  description: Endpoints relating to retrieving, managing AAA subscriptions
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Account Activity
  properties:
  - type: OpenAPI
    url: openapi/twitter-account-activity-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-activity-api
  name: X (Twitter) Activity API
  description: The Activity API from X (Twitter) — 3 operation(s) for activity.
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Activity
  properties:
  - type: OpenAPI
    url: openapi/twitter-activity-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-bookmarks-api
  name: X (Twitter) Bookmarks API
  description: Endpoints related to retrieving, managing bookmarks of a user
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Bookmarks
  properties:
  - type: OpenAPI
    url: openapi/twitter-bookmarks-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-chat-api
  name: X (Twitter) Chat API
  description: The Chat API from X (Twitter) — 15 operation(s) for chat.
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Chat
  properties:
  - type: OpenAPI
    url: openapi/twitter-chat-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-communities-api
  name: X (Twitter) Communities API
  description: The Communities API from X (Twitter) — 2 operation(s) for communities.
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Communities
  properties:
  - type: OpenAPI
    url: openapi/twitter-communities-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-community-notes-api
  name: X (Twitter) Community Notes API
  description: The Community Notes API from X (Twitter) — 5 operation(s) for community notes.
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Community Notes
  properties:
  - type: OpenAPI
    url: openapi/twitter-community-notes-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-compliance-api
  name: X (Twitter) Compliance API
  description: Endpoints related to keeping X data in your systems compliant
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Compliance
  properties:
  - type: OpenAPI
    url: openapi/twitter-compliance-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-connections-api
  name: X (Twitter) Connections API
  description: Endpoints related to streaming connections
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Connections
  properties:
  - type: OpenAPI
    url: openapi/twitter-connections-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-direct-messages-api
  name: X (Twitter) Direct Messages API
  description: Endpoints related to retrieving, managing Direct Messages
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Direct Messages
  properties:
  - type: OpenAPI
    url: openapi/twitter-direct-messages-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-general-api
  name: X (Twitter) General API
  description: Miscellaneous endpoints for general API functionality
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - General
  properties:
  - type: OpenAPI
    url: openapi/twitter-general-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-likes-api
  name: X (Twitter) Likes API
  description: The Likes API from X (Twitter) — 2 operation(s) for likes.
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Likes
  properties:
  - type: OpenAPI
    url: openapi/twitter-likes-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-lists-api
  name: X (Twitter) Lists API
  description: Endpoints related to retrieving, managing Lists
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Lists
  properties:
  - type: OpenAPI
    url: openapi/twitter-lists-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-media-api
  name: X (Twitter) Media API
  description: Endpoints related to Media
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Media
  properties:
  - type: OpenAPI
    url: openapi/twitter-media-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-news-api
  name: X (Twitter) News API
  description: Endpoint for retrieving news stories
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - News
  properties:
  - type: OpenAPI
    url: openapi/twitter-news-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-spaces-api
  name: X (Twitter) Spaces API
  description: Endpoints related to retrieving, managing Spaces
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Spaces
  properties:
  - type: OpenAPI
    url: openapi/twitter-spaces-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-stream-api
  name: X (Twitter) Stream API
  description: Endpoints related to streaming
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Stream
  properties:
  - type: OpenAPI
    url: openapi/twitter-stream-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-trends-api
  name: X (Twitter) Trends API
  description: The Trends API from X (Twitter) — 2 operation(s) for trends.
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Trends
  properties:
  - type: OpenAPI
    url: openapi/twitter-trends-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-tweets-api
  name: X (Twitter) Tweets API
  description: Endpoints related to retrieving, searching, and modifying Tweets
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Tweets
  properties:
  - type: OpenAPI
    url: openapi/twitter-tweets-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-usage-api
  name: X (Twitter) Usage API
  description: The Usage API from X (Twitter) — 1 operation(s) for usage.
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Usage
  properties:
  - type: OpenAPI
    url: openapi/twitter-usage-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-users-api
  name: X (Twitter) Users API
  description: Endpoints related to retrieving, managing relationships of Users
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/twitter-users-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
- aid: twitter:twitter-webhooks-api
  name: X (Twitter) Webhooks API
  description: The Webhooks API from X (Twitter) — 5 operation(s) for webhooks.
  humanURL: https://docs.x.com/x-api
  baseURL: https://api.x.com/2
  tags:
  - Webhooks
  properties:
  - type: OpenAPI
    url: openapi/twitter-webhooks-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api
  - type: GettingStarted
    url: https://docs.x.com/x-api/getting-started/make-your-first-request
  - type: APIReference
    url: https://docs.x.com/x-api
  - type: Authentication
    url: https://docs.x.com/resources/fundamentals/authentication
  - type: RateLimits
    url: https://docs.x.com/x-api/fundamentals/rate-limits
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/python-xdk
  - type: SDKs
    url: https://docs.x.com/sdks-and-tools/typescript-xdk
  - type: GraphQL
    url: graphql/twitter-graphql.md
common:
- type: AgenticAccess
  url: agentic-access/twitter-agentic-access.yml
- type: Authentication
  url: authentication/twitter-authentication.yml
- type: OAuthScopes
  url: scopes/twitter-scopes.yml
- type: Arazzo
  url: arazzo/twitter-bookmark-and-remove-workflow.yml
  name: X Search, Bookmark a Post, Then Remove the Bookmark
- type: Arazzo
  url: arazzo/twitter-create-list-add-member-workflow.yml
  name: X Create a List and Add a Member by Username
- type: Arazzo
  url: arazzo/twitter-follow-list-by-id-workflow.yml
  name: X Confirm a List and Follow It
- type: Arazzo
  url: arazzo/twitter-follow-user-by-username-workflow.yml
  name: X Follow a User by Their Username
- type: Arazzo
  url: arazzo/twitter-followers-of-handle-workflow.yml
  name: X List the Followers of a Handle
- type: Arazzo
  url: arazzo/twitter-liked-posts-of-handle-workflow.yml
  name: X List the Posts a Handle Has Liked
- type: Arazzo
  url: arazzo/twitter-list-detail-and-members-workflow.yml
  name: X Fetch a List's Details and Its Members
- type: Arazzo
  url: arazzo/twitter-mentions-of-handle-workflow.yml
  name: X List the Posts Mentioning a Handle
- type: Arazzo
  url: arazzo/twitter-mute-user-by-username-workflow.yml
  name: X Mute a User by Their Username
- type: Arazzo
  url: arazzo/twitter-pin-owned-list-workflow.yml
  name: X Pin the Authenticated User's First Owned List
- type: Arazzo
  url: arazzo/twitter-post-engagement-audit-workflow.yml
  name: X Audit Engagement on a User's Latest Post
- type: Arazzo
  url: arazzo/twitter-post-like-cleanup-workflow.yml
  name: X Create a Post, Like It, Then Delete It
- type: Arazzo
  url: arazzo/twitter-quote-post-from-search-workflow.yml
  name: X Quote a Post Found by Search
- type: Arazzo
  url: arazzo/twitter-reply-to-latest-post-workflow.yml
  name: X Reply to a User's Latest Post
- type: Arazzo
  url: arazzo/twitter-repost-then-undo-workflow.yml
  name: X Find a Post, Repost It, Then Undo the Repost
- type: Arazzo
  url: arazzo/twitter-reposters-of-latest-post-workflow.yml
  name: X List Who Reposted a Handle's Latest Post
- type: Arazzo
  url: arazzo/twitter-search-recent-get-details-workflow.yml
  name: X Search Recent Posts and Hydrate the Top Match
- type: Arazzo
  url: arazzo/twitter-unfollow-user-by-username-workflow.yml
  name: X Unfollow a User by Their Username
- type: Arazzo
  url: arazzo/twitter-user-lookup-recent-posts-workflow.yml
  name: X Resolve User and List Their Recent Posts
- type: LinkedIn
  url: https://www.linkedin.com/company/x-corp
- type: Portal
  url: https://developer.x.com/en/portal/dashboard
- type: GettingStarted
  url: https://docs.x.com/x-api/getting-started/make-your-first-request
- type: Console
  url: https://developer.x.com/en/portal/dashboard
- type: Signup
  url: https://developer.x.com/en/portal/petition/essential/basic-info
- type: Authentication
  url: https://docs.x.com/resources/fundamentals/authentication
- type: SDKs
  url: https://docs.x.com/sdks-and-tools/python-xdk
  title: Python XDK
- type: SDKs
  url: https://docs.x.com/sdks-and-tools/typescript-xdk
  title: TypeScript XDK
- type: CLI
  url: https://docs.x.com/sdks-and-tools/xurl
  title: xurl
- type: Pricing
  url: https://developer.x.com/en/portal/petition/essential/basic-info
- type: TermsOfService
  url: https://developer.x.com/en/developer-terms/agreement-and-policy
- type: PrivacyPolicy
  url: https://x.com/en/privacy
- type: StatusPage
  url: https://api.twitterstat.us/
- type: Support
  url: https://devcommunity.x.com/
- type: Blog
  url: https://blog.x.com/developer
- type: ReleaseNotes
  url: https://docs.x.com/changelog
- type: GitHubOrganization
  url: https://github.com/xdevplatform
- type: GitHubRepository
  url: https://github.com/xdevplatform/xdk-python
  description: Auto-generated Python SDK for the X API.
- type: GitHubRepository
  url: https://github.com/xdevplatform/xdk-typescript
  description: Auto-generated TypeScript SDK for the X API.
- type: GitHubRepository
  url: https://github.com/xdevplatform/xurl
  description: Official CLI for the X API with built-in authentication.
- type: GitHubRepository
  url: https://github.com/xdevplatform/xdk
  description: SDK generator for the X APIs producing auto-generated client libraries.
- type: GitHubRepository
  url: https://github.com/xdevplatform/twitter-api-java-sdk
  description: Official Java SDK for the Twitter/X API.
- type: GitHubRepository
  url: https://github.com/xdevplatform/twitter-ruby-ads-sdk
  description: Official Ruby SDK for the Twitter/X Ads API.
- type: Tools
  url: https://github.com/xdevplatform/xmcp
  description: MCP server for the X API enabling AI agent integration.
- type: Sandbox
  url: https://github.com/xdevplatform/playground
  description: Standalone local HTTP server simulating the X API v2 for testing and development with interactive web UI.
- type: CodeExamples
  url: https://github.com/xdevplatform/samples
  description: Official sample code for X API v2 endpoints.
- type: CodeExamples
  url: https://github.com/xdevplatform/xchat-bot-python
  description: Example DM reply bot in Python for X encrypted chat system.
- type: PostmanWorkspace
  url: https://docs.x.com/sdks-and-tools/postman
- type: PostmanCollection
  url: postman/x-api-v2-postman-collection.json
- type: X
  url: https://x.com/XDevelopers
- type: Features
  data:
  - name: Post Management
    description: Create, delete, edit, repost, quote, like, and bookmark posts programmatically.
  - name: Real-Time Streaming
    description: Access filtered streams, sampled streams, firehose, and language-specific streams for real-time post data.
  - name: Full-Archive Search
    description: Search the complete archive of public posts with advanced query operators and date filtering.
  - name: User Lookup and Management
    description: Look up users by ID or username, manage follows, blocks, mutes, and retrieve user metrics.
  - name: Spaces
    description: Discover and look up live audio Spaces with host, speaker, and listener data.
  - name: Direct Messages
    description: Send and receive direct messages, create conversations, and manage participants.
  - name: Lists
    description: Create, manage, and query lists including membership, followers, and pinned lists.
  - name: Trends
    description: Access personalized and geographic trending topics.
  - name: Media Upload
    description: Upload images, videos, and large files using chunked upload with metadata and subtitle support.
  - name: Compliance
    description: Access compliance streams and batch jobs for data deletion and user protection events.
  - name: Communities and Community Notes
    description: Access community data and community notes for collaborative fact-checking.
  - name: Ad Campaign Management
    description: Programmatically create, schedule, and manage advertising campaigns with targeting and budget controls.
- type: UseCases
  data:
  - name: Social Listening
    description: Monitor brand mentions, sentiment, and conversations in real-time using filtered streams and search endpoints.
  - name: Content Publishing
    description: Automate post creation, scheduling, and thread publishing for social media management platforms.
  - name: Analytics and Reporting
    description: Retrieve post metrics, user engagement data, and campaign performance for business intelligence.
  - name: Bot Development
    description: Build automated accounts that respond to mentions, post updates, or provide customer service.
  - name: Research and Academic Analysis
    description: Access full-archive search and streaming data for social media research and trend analysis.
  - name: Advertising Automation
    description: Programmatically manage ad campaigns, audiences, creatives, and bidding strategies at scale.
  - name: Real-Time Event Monitoring
    description: Track live events, breaking news, and trending topics with streaming APIs and trend endpoints.
  - name: Community Management
    description: Manage followers, lists, and direct messages for community engagement and moderation.
- type: Integrations
  data:
  - name: Postman
    description: Official Postman collections for exploring and testing X API endpoints interactively.
  - name: MCP Servers
    description: Integration with AI tools and agents through Model Context Protocol servers.
  - name: Webhook Delivery
    description: Real-time event delivery via webhooks for the Activity API.
- type: Solutions
  data:
  - name: X API Pay-Per-Use
    description: Credit-based pricing with no commitments. Pay only for what you use with access to core X API endpoints.
  - name: X API Enterprise
    description: High-volume access with custom rate limits, dedicated account management, full firehose, and premium support.
  - name: X Ads API
    description: Advertising platform API for campaign management, audience targeting, creative management, and analytics.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com