Twitter/X

X (formerly Twitter) operates the X Developer Platform, giving developers programmatic access to the public conversation through the X API v2 — Posts, Users, Direct Messages, Lists, Spaces, Communities, Community Notes, Trends, News, Media, and real-time delivery via filtered/sample/firehose streams and webhooks (X Activity, Account Activity, Filtered Stream Webhooks). The platform runs credit-based Pay-Per-Use pricing with a Developer Console at console.x.com, first-party Python and TypeScript XDKs, the xurl CLI, a local Playground mock server, and an unusually deep agent-native surface: llms.txt, AGENTS.md, skill.md, and hosted MCP servers for both the API and its documentation.

Twitter/X publishes 22 APIs on the APIs.io network, including Account Activity API, Activity API, Articles API, and 19 more. Tagged areas include Company, Social, Social Media, Posts, and Real-Time.

The Twitter/X catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Twitter/X’s developer surface includes documentation, API reference, getting-started guide, support, pricing, signup flow, changelog, and 31 more developer resources.

🌐 Visit website 📡 Source on GitHub
65.0/100 strong ▬ flat Agent 85/100 agent native Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
22 APIs 1 MCP Servers
CompanySocialSocial MediaPostsReal-TimeStreamingNewsDeveloper Platform

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 65.0/100 · strong
Contract Quality 15.9 / 25
Developer Ergonomics 17.8 / 20
Commercial Clarity 8.9 / 20
Operational Transparency 12.3 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 85/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 3 / 3
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-x: 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 22

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

Twitter/X Account Activity API

Endpoints relating to retrieving, managing AAA subscriptions

Twitter/X Activity API

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

Twitter/X Articles API

Endpoints related to retrieving, creating & modifying Articles

Twitter/X Bookmarks API

Endpoints related to retrieving, managing bookmarks of a user

Twitter/X Chat API

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

Twitter/X Communities API

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

Twitter/X Community Notes API

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

Twitter/X Compliance API

Endpoints related to keeping X data in your systems compliant

Twitter/X Connections API

Endpoints related to streaming connections

Twitter/X Direct Messages API

Endpoints related to retrieving, managing Direct Messages

Twitter/X General API

Miscellaneous endpoints for general API functionality

Twitter/X Likes API

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

Twitter/X Lists API

Endpoints related to retrieving, managing Lists

Twitter/X Media API

Endpoints related to Media

Twitter/X News API

Endpoint for retrieving news stories

Twitter/X Spaces API

Endpoints related to retrieving, managing Spaces

Twitter/X Stream API

Endpoints related to streaming

Twitter/X Trends API

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

Twitter/X Tweets API

Endpoints related to retrieving, searching, and modifying Tweets

Twitter/X Usage API

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

Twitter/X Users API

Endpoints related to retrieving, managing relationships of Users

Twitter/X Webhooks API

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

Scroll for all 22

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

twitter-x-mcp.yml

MCP SERVER

Rate Limits 1

Documented rate limits and quota policies.

Twitter X Rate Limits

18 limits

RATE LIMITS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Twitter X Webhooks

ASYNCAPI

Security Posture 3

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

Twitter X Authentication

http/oauth2 · 3 schemes

SECURITY

Twitter X Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Twitter X Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Twitter X Scopes

21 scopes · authorizationCode

21 scopes

SCOPES

Agentic Access 1

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

Twitter X Agentic Access

165 operations · 68 acting · 3 human-in-the-loop

165 operations · 68 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp
 Sandbox
Sandbox

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 WellKnown
WellKnown
 MCPServer
MCPServer
 LLMsTxt
LLMsTxt
 AgentSkill
AgentSkill

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Lifecycle
Lifecycle
 Conformance
Conformance
 ErrorCatalog
ErrorCatalog
 Conventions
Conventions
 Webhooks
Webhooks
 Components
Components
 DataModel
DataModel

Scroll for all 7

Build 5

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 Postman
Postman
 Packages
Packages
 SDKs
SDKs
 CLI
CLI

Access & Security 6

Authentication, authorization, and security posture

Authentication
Authentication
 OAuthScopes
OAuthScopes
 Security
Security
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 SecurityTxt
SecurityTxt

Operate 5

Status, limits, changes, and where to get help

Support
Support
 StatusPage
StatusPage
 Deprecation
Deprecation
 ChangeLog
ChangeLog
 RateLimits
RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 1

The organization behind the API

Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: twitter-x
name: Twitter/X
description: 'X (formerly Twitter) operates the X Developer Platform, giving developers programmatic access to the public
  conversation through the X API v2 — Posts, Users, Direct Messages, Lists, Spaces, Communities, Community Notes, Trends,
  News, Media, and real-time delivery via filtered/sample/firehose streams and webhooks (X Activity, Account Activity, Filtered
  Stream Webhooks). The platform runs credit-based Pay-Per-Use pricing with a Developer Console at console.x.com, first-party
  Python and TypeScript XDKs, the xurl CLI, a local Playground mock server, and an unusually deep agent-native surface: llms.txt,
  AGENTS.md, skill.md, and hosted MCP servers for both the API and its documentation.'
url: https://raw.githubusercontent.com/api-evangelist/twitter-x/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- spark-capital
x-tier: stub
x-tier-reason: portfolio-lead
x-enrichment:
  date: '2026-07-21'
  status: enriched
  artifacts_added: 30
  pass: local-v1
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-21'
image: https://abs.twimg.com/favicons/twitter.3.ico
tags:
- Company
- Social
- Social Media
- Posts
- Real-Time
- Streaming
- News
- Developer Platform
apis:
- aid: twitter-x:twitter-x-account-activity-api
  name: Twitter/X Account Activity API
  description: Endpoints relating to retrieving, managing AAA subscriptions
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Account Activity
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-account-activity-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-activity-api
  name: Twitter/X Activity API
  description: The Activity API from Twitter/X — 3 operation(s) for activity.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Activity
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-activity-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-articles-api
  name: Twitter/X Articles API
  description: Endpoints related to retrieving, creating & modifying Articles
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Articles
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-articles-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-bookmarks-api
  name: Twitter/X Bookmarks API
  description: Endpoints related to retrieving, managing bookmarks of a user
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Bookmarks
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-bookmarks-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-chat-api
  name: Twitter/X Chat API
  description: The Chat API from Twitter/X — 16 operation(s) for chat.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Chat
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-chat-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-communities-api
  name: Twitter/X Communities API
  description: The Communities API from Twitter/X — 2 operation(s) for communities.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Communities
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-communities-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-community-notes-api
  name: Twitter/X Community Notes API
  description: The Community Notes API from Twitter/X — 5 operation(s) for community notes.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Community Notes
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-community-notes-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-compliance-api
  name: Twitter/X Compliance API
  description: Endpoints related to keeping X data in your systems compliant
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Compliance
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-compliance-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-connections-api
  name: Twitter/X Connections API
  description: Endpoints related to streaming connections
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Connections
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-connections-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-direct-messages-api
  name: Twitter/X Direct Messages API
  description: Endpoints related to retrieving, managing Direct Messages
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Direct Messages
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-direct-messages-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-general-api
  name: Twitter/X General API
  description: Miscellaneous endpoints for general API functionality
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - General
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-general-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-likes-api
  name: Twitter/X Likes API
  description: The Likes API from Twitter/X — 2 operation(s) for likes.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Likes
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-likes-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-lists-api
  name: Twitter/X Lists API
  description: Endpoints related to retrieving, managing Lists
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Lists
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-lists-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-media-api
  name: Twitter/X Media API
  description: Endpoints related to Media
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Media
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-media-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-news-api
  name: Twitter/X News API
  description: Endpoint for retrieving news stories
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - News
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-news-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-spaces-api
  name: Twitter/X Spaces API
  description: Endpoints related to retrieving, managing Spaces
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Spaces
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-spaces-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-stream-api
  name: Twitter/X Stream API
  description: Endpoints related to streaming
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Stream
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-stream-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-trends-api
  name: Twitter/X Trends API
  description: The Trends API from Twitter/X — 2 operation(s) for trends.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Trends
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-trends-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-tweets-api
  name: Twitter/X Tweets API
  description: Endpoints related to retrieving, searching, and modifying Tweets
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Tweets
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-tweets-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-usage-api
  name: Twitter/X Usage API
  description: The Usage API from Twitter/X — 1 operation(s) for usage.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Usage
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-usage-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-users-api
  name: Twitter/X Users API
  description: Endpoints related to retrieving, managing relationships of Users
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-users-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
- aid: twitter-x:twitter-x-webhooks-api
  name: Twitter/X Webhooks API
  description: The Webhooks API from Twitter/X — 5 operation(s) for webhooks.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Webhooks
  properties:
  - type: OpenAPI
    url: openapi/twitter-x-webhooks-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
  - type: APIReference
    url: https://docs.x.com/x-api/introduction
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: AgenticAccess
  url: agentic-access/twitter-x-agentic-access.yml
- type: Website
  url: https://x.com
- type: DeveloperPortal
  url: https://developer.x.com
- type: Documentation
  url: https://docs.x.com
- type: APIReference
  url: https://docs.x.com/x-api/introduction
- type: GettingStarted
  url: https://docs.x.com/make-your-first-request
- type: Support
  url: https://devcommunity.x.com
- type: GitHubOrganization
  url: https://github.com/xdevplatform
- type: Pricing
  url: https://docs.x.com/x-api/getting-started/pricing
- type: SignUp
  url: https://console.x.com
- type: TermsOfService
  url: https://developer.x.com/en/developer-terms/agreement-and-policy
- type: PrivacyPolicy
  url: https://x.com/en/privacy
- type: Postman
  url: https://www.postman.com/xapidevelopers/x-api-public-workspace/overview
- type: StatusPage
  url: https://docs.x.com/status
- type: Deprecation
  url: https://docs.x.com/x-api/fundamentals/versioning
- type: ChangeLog
  url: changelog/twitter-x-changelog.yml
- type: Lifecycle
  url: lifecycle/twitter-x-lifecycle.yml
- type: Authentication
  url: authentication/twitter-x-authentication.yml
- type: OAuthScopes
  url: scopes/twitter-x-scopes.yml
- type: Security
  url: https://hackerone.com/twitter
- type: VulnerabilityDisclosure
  url: security/twitter-x-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/twitter-x-domain-security.yml
- type: SecurityTxt
  url: well-known/twitter-x-security.txt
- type: WellKnown
  url: well-known/twitter-x-well-known.yml
- type: Packages
  url: packages/twitter-x-packages.yml
- type: SDKs
  url: packages/twitter-x-packages.yml
- type: CLI
  url: cli/twitter-x-cli.yml
- type: MCPServer
  url: mcp/twitter-x-mcp.yml
- type: LLMsTxt
  url: llms/twitter-x-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: Conformance
  url: conformance/twitter-x-conformance.yml
- type: ErrorCatalog
  url: errors/twitter-x-problem-types.yml
- type: Conventions
  url: conventions/twitter-x-conventions.yml
- type: RateLimits
  url: rate-limits/twitter-x-rate-limits.yml
- type: Webhooks
  url: asyncapi/twitter-x-webhooks.yml
- type: Sandbox
  url: sandbox/twitter-x-sandbox.yml
- type: Components
  url: components/twitter-x-components.yml
- type: DataModel
  url: data-model/twitter-x-data-model.yml