X

X (formerly Twitter) operates the X Developer Platform, the programmable interface to the public conversation on X. The X API v2 is a 190-operation REST surface covering Posts, Users, Direct Messages, the encrypted Chat API, Lists, Spaces, Media, Communities, Community Notes, Broadcasts, News, Trends, Articles and Bots, plus a substantial real-time layer — filtered stream, firehose and sample volume streams, compliance streams, Account Activity webhooks and the X Activity API. X publishes a machine-readable OpenAPI at api.x.com/2/openapi.json, an llms.txt family, an AGENTS.md, an agentskills.io skill, an A2A agent card and two hosted MCP servers. Access is sold pay-per-usage in prepaid credits rather than by subscription tier, with an Enterprise agreement for volume above the published cap.

X publishes 24 API contracts indexed on the APIs.io network, including Account Activity API, Account API, Activity API, and 21 more. Tagged areas include Spaces, Conversations, X, Social, and Social Media.

The X catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.

X’s developer surface includes authentication, CLI, sandbox, changelog, documentation, API reference, getting-started guide, and 46 more developer resources.

🌐 Visit website 📡 Profile data on GitHub

75.0/100 exemplar ▬ flat Agent 61/100 agent native Front door AI 1/6 silent Heartbeat 100/100 alive saas Full breakdown ↓
scored 2026-11-13 · rubric v0.28.0 · Show this score on your site →

AccessPaidSelf serve⚡ Free to try

2 published contracts 1 MCP Servers 1 Agent Skills

Spaces Conversations X Social Social Media Posts User Direct Messages Streaming Webhook Real-Time Trends Media Content Agents MCP A2A

What this lets a business do 2

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Developer Platform & API Ecosystem Management

BC-4270

AccountAccount ActivityActivityUsageWebhooks

POST /2/account_activity/webhooks/{webhook_id}/subscriptions/all POST /2/webhooks POST /2/webhooks/replay GET /2/account

Media, Creator & Social

AE-170

ArticlesPosts

GET /2/tweets POST /2/tweets GET /2/tweets/search/recent GET /2/tweets/{id}

What people ask X 23

The questions people put to an LLM, and the jobs they hand an agent, that X's APIs answer — each one linked to the operation that does it. Generated by API Evangelist

X Users API Look up several users by ID “Can I fetch profiles for a batch of user IDs at once?” Look up several users by username “How do I turn a list of @handles into user profiles in one call?” Look up one user by username (v2) “What's the v2 way to get a single profile from an @handle?” Get the authenticated user's profile “Which account is my access token acting as?”

X Posts API Look up several posts by ID “Can I fetch a batch of posts in a single request?” Publish a post “What's the v2 call to publish a post?” Get engagement analytics for posts “How did my posts perform over a given time window?” Count matching posts across the full archive “How many posts mentioned a keyword across all of X's history?”

X Stream API Stream X activity events “Can I open a live stream of the activity events I've subscribed to?” Stream Likes compliance events “Where do I get compliance events about Likes I've stored?” Stream every public Like “Is there a firehose of all public Likes in real time?” Stream a 10% sample of Likes “Can I get a 10 percent sample of public Likes instead of the whole firehose?”

X Chat API List my Chat inbox conversations “Which encrypted Chat conversations are in my inbox?” Create an encrypted Chat group “How do I finish creating an encrypted Chat group after initializing it?” Reserve an ID for a new Chat group “What's the first step to create a new Chat group conversation?” Get a Chat conversation's details “How can I see whether a Chat conversation is muted and who its admins are?”

X Broadcasts API List my live-video broadcasts “How can I see all the live-video broadcasts I've run on X?” List my scheduled broadcasts “Which upcoming broadcasts do I have scheduled?” Schedule a live broadcast “How do I schedule a live-video broadcast ahead of time?” Delete a scheduled broadcast “Can I cancel a broadcast I scheduled earlier?”

X Media API Look up several media items by key “Can I get details for a batch of media keys in one call?” Get analytics for media items “How are my uploaded videos performing over a date range?” Add metadata to uploaded media “Can I attach extra metadata to an image after uploading it?” Remove subtitles from a video “How do I delete a subtitle track in a particular language from a video?”

X Direct Messages API Start a group DM conversation “How do I start a new group Direct Message with several people?” Download media from a legacy DM “Can I download a photo or video attached to an older Direct Message?” Get my DM history with one person “What have I and a specific user said to each other in DMs?” Send a DM to a user “How do I send a Direct Message to someone by their user ID?”

X Lists API Create a List “Can I create a new List on X via the API?” Delete a List I own “What's the call to delete one of my Lists?” Get a List's details “What are the name, owner and description of a given List?” Rename or edit a List I own “Can I rename an existing List or change its description?”

X Webhooks API List filtered-stream webhook links “Which webhooks are currently receiving my filtered stream events?” Stop filtered stream delivery to a webhook “Can I stop filtered stream events going to a webhook?” Deliver filtered stream events to a webhook “How do I get filtered stream matches pushed to a webhook instead of holding a connection open?” List my app's webhook configs “Which webhook URLs are registered for my app?”

X Compliance API List compliance jobs by type “Which batch compliance jobs have I created for posts or users?” Create a batch compliance job “How do I check a stored dataset of post or user IDs for deletions and suspensions?” Cancel an unfinished compliance job “Can I cancel a compliance job that's still processing so I can start another of the same type?” Check a compliance job's status “Has my compliance job finished processing yet?”

X Bots API List bots in my project “Which bot accounts exist in my app's project?” Create a bot account “How do I create a bot account and get its bearer token?” Delete a bot account “What's needed to permanently remove a bot from my project?” Update a bot's handle, name or DM permission “Can I rename an existing bot or change its handle?”

X Spaces API Look up several Spaces by ID “Can I fetch details for multiple Spaces in one request?” Find Spaces hosted by given users “Which Spaces are certain users hosting?” Search Spaces by keyword “Are there any live Spaces about a topic right now?” Get one Space by ID “What details does a single Space expose?”

Showing 12 of 23 APIs with phrasing — see every API.

Kin Score

Kin Score How this is scored →
scored 2026-11-13 · rubric v0.28.0

Composite quality — 75.0/100 · exemplar

Contract Quality 10.8 / 19

Developer Ergonomics 11.4 / 15

Access Clarity 12.5 / 15

Operational Transparency 7.9 / 10

Contract Governance 2.9 / 9

Discoverability 5.6 / 8

Regulatory Posture 6.0 / 15

Create-or-Update Ergonomics 3.9 / 10

Agent readiness — 61/100 · agent native

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 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 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 4 / 4

Delegated User Identity 6 / 6

Protected Resource Metadata 5 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Pagination 5 / 5

Distinct Operations 3 / 3

MCP Tool Quality 6 / 6

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Show this score on your site.

It updates itself when the score changes. Paste this where you link to your API docs:

<a href="https://apis.io/providers/x/"><img src="https://apis.io/badge/x/card.svg" alt="X on APIs.io — Kin Score by API Evangelist"></a>

Other styles, a README pill and a shields.io endpoint are on the badge page.

Raise your score.

Agent readiness — checks not met, largest first (exact, from this profile):

A2A Agent Card +8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0 Ask about this →
Request/Response Examples +7 pts — share of operations carrying request/response examples; else an Examples / Code Samples link Ask about this →
Registration Without a Human +6 pts — a `registration_endpoint` in the served RFC 8414 / OIDC discovery document Ask about this →
Agentic Commerce Well-Known Document +5 pts — a parsing /.well-known/ucp.json or acp.json declaring a version and at least one service, OR (0.27) a live x402 payment challenge from _data/x402-adoption.json — `self` when its endpoints are on the provider's own domain, `platform` when they are on a vendor's Ask about this →
Consent & Bot Identity +3 pts — common[].type includes AIPREF, ContentSignal, WebBotAuth, or HTTPMessageSignatures Ask about this →

Kin Score — facets with the most composite points still available (weight × headroom):

Contract Quality scores 57.6 — up to +10.6 composite points Ask about this →
Contract Governance scores 31.8 — up to +8.2 composite points Ask about this →
Developer Ergonomics scores 76.2 — up to +4.8 composite points Ask about this →

Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.

Not sure how this applies to your stack? Ask about any one item. Kin Lane reads every question, looks at your profile and your situation, and replies with what a fix would take — scoped to that one area, priced up front, yours whether you ship it or not. Ask a question →

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from the provider profile at artifacts.apis.io/x/apis.yml: open an issue on github.com/api-evangelist/x to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

Market	Position	Depth	Registered MCP server	Declares compatibility
Social and Fediverse	distribution	19.2 (thin)	-	2
Agent Skills (SKILL.md packages)	distribution	19.2 (thin)	-	2

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

Standards implemented 6

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

Agent2Agent

tagged — the provider's own APIs.json carries the standard as a tag; implementation not verified

Model Context Protocol (MCP)

measured — observed by APIs.io (verified)

Agent Skills

measured — observed by APIs.io (published)

OAuth 2.0 Protected Resource Metadata

measured — observed by APIs.io (verified)

OpenAPI

measured — observed by APIs.io (published)

OAuth 2.0

measured — observed by APIs.io (declared)

APIs 24

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

X Account Activity API

Endpoints relating to retrieving, managing Account Activity subscriptions — 5 operation(s) in the X-published contract.

X Account API

Endpoints for managing the authenticated user's X Developer Platform account — 2 operation(s) in the X-published contract.

X Activity API

Endpoints relating to retrieving, managing activity subscriptions — 5 operation(s) in the X-published contract.

X Articles API

Endpoints related to retrieving, creating & modifying Articles — 2 operation(s) in the X-published contract.

X Bots API

The Bots surface of the X API v2. — 6 operation(s) in the X-published contract.

X Broadcasts API

Endpoints related to live broadcasts and their chat — 13 operation(s) in the X-published contract.

X Chat API

Endpoints related to Chat encrypted messaging — 16 operation(s) in the X-published contract.

X Communities API

Endpoints related to retrieving and managing Communities — 2 operation(s) in the X-published contract.

X Community Notes API

Endpoints related to retrieving, searching, and modifying Community Notes — 5 operation(s) in the X-published contract.

X Compliance API

Endpoints related to keeping X data in your systems compliant — 6 operation(s) in the X-published contract.

X Connections API

Endpoints related to streaming connections — 4 operation(s) in the X-published contract.

X Direct Messages API

Endpoints related to retrieving, managing Direct Messages — 9 operation(s) in the X-published contract.

X General API

Miscellaneous endpoints for general API functionality — 1 operation(s) in the X-published contract.

X Lists API

Endpoints related to retrieving, managing Lists — 9 operation(s) in the X-published contract.

X Media API

Endpoints related to retrieving and uploading Media — 11 operation(s) in the X-published contract.

X News API

Endpoint for retrieving news stories — 2 operation(s) in the X-published contract.

X Posts API

Endpoints related to retrieving, searching, and modifying Posts — 14 operation(s) in the X-published contract.

X Spaces API

Endpoints related to retrieving, managing Spaces — 6 operation(s) in the X-published contract.

X Stream API

Endpoints related to streaming — 18 operation(s) in the X-published contract.

X Trends API

Endpoint for retrieving trends — 2 operation(s) in the X-published contract.

X Usage API

Endpoints related to retrieving usage — 2 operation(s) in the X-published contract.

X Users API

Endpoints related to retrieving, managing relationships of Users — 42 operation(s) in the X-published contract.

X Webhooks API

Endpoints relating to retrieving, managing webhooks and webhook configs — 8 operation(s) in the X-published contract.

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...

Scroll for all 24

Open Collections 4

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

X API v2 Posts API

OPEN COLLECTION

X API v2 Posts Trends API

OPEN COLLECTION

X API v2 Posts Users API

OPEN COLLECTION

X API v2

OPEN COLLECTION

MCP Servers 1

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

X MCP Server

X ships TWO hosted MCP servers: an API server at https://api.x.com/mcp that calls X API v2 endpoints, and a documentation-search server at https://docs.x.com/mcp. Both are Strea...

MCP SERVER

Agent Skills 1

Packaged agent skills for driving this provider's APIs from an AI assistant.

X

AGENT SKILL

X API pricing

Prices published by X, read 2026-10-28 from docs.x.com/x-api/getting-started/pricing.

Plan	Price
Posts: Read	$0.005 per resource
User: Read	$0.010 per resource
Like: Read	$0.001 per resource
Post: Create	$0.015 per request
Post: Create (with URL)	$0.200 per request
Owned Reads	$0.001 per resource
Enterprise	upgrade to an Enterprise plan

Plan details, limits and sources →

Billed by: resource · FinOps profile →

Pricing Plans 2

Published pricing tiers and plan structures.

X Plans Pricing

7 plans

PLANS

X Price Estimates

0 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

X Rate Limits

17 limits

RATE LIMITS

Service Levels 1

Uptime the provider promises or reports, as SLA4OAI. Read from its own pages; APIs.io runs no monitors.

X

SLA

Terms of Service 1

What its API terms permit and prohibit, quoted from its own page.

X

10 quoted statements, read from X's own page on 2026-11-10.

TERMS

Privacy & Data 1

Its role, the data it processes, retention and transfers, quoted from its own privacy page.

X

25 quoted statements, read from X's own page on 2026-11-10.

PRIVACY

Deprecation Policy 1

Notice periods, support windows and the headers it sends, quoted from its own page.

X

5 quoted statements, read from X's own page on 2026-11-10.

DEPRECATION

Eligibility 1

Who may sign up and where, quoted from its own terms.

X

3 quoted statements, read from X's own page on 2026-11-10.

ELIGIBILITY

AI Preferences 1

Its stance on AI training, inference and agents, quoted from its own pages.

X

1 quoted statement, read from X's own page on 2026-11-10.

AI PREFS

Data License 1

How its data and outputs may be reused, quoted from its own terms.

X

1 quoted statement, read from X's own page on 2026-11-10.

LICENSE

FinOps 1

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

X Finops

FINOPS

Event Specifications 1

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

X Webhooks

ASYNCAPI

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs. Counts are the severity each rule declares, not results of running them.

X API Rules

77 rules · 55 error-severity 13 warn-severity 9 info-severity

SPECTRAL

OpenAPI Overlays 24

Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.

X Account Activity Api Phrasing Overlay

6 actions · phrasing · x-account-activity-api-openapi.yml

GENERATED

X Account Api Phrasing Overlay

3 actions · phrasing · x-account-api-openapi.yml

GENERATED

X Activity Api Phrasing Overlay

6 actions · phrasing · x-activity-api-openapi.yml

GENERATED

X Api V2 Overlay

2 actions · update

DERIVED

X Articles Api Phrasing Overlay

3 actions · phrasing · x-articles-api-openapi.yml

GENERATED

X Bots Api Phrasing Overlay

7 actions · phrasing · x-bots-api-openapi.yml

GENERATED

X Broadcasts Api Phrasing Overlay

14 actions · phrasing · x-broadcasts-api-openapi.yml

GENERATED

X Chat Api Phrasing Overlay

17 actions · phrasing · x-chat-api-openapi.yml

GENERATED

X Communities Api Phrasing Overlay

3 actions · phrasing · x-communities-api-openapi.yml

GENERATED

X Community Notes Api Phrasing Overlay

6 actions · phrasing · x-community-notes-api-openapi.yml

GENERATED

X Compliance Api Phrasing Overlay

7 actions · phrasing · x-compliance-api-openapi.yml

GENERATED

X Connections Api Phrasing Overlay

5 actions · phrasing · x-connections-api-openapi.yml

GENERATED

X Direct Messages Api Phrasing Overlay

10 actions · phrasing · x-direct-messages-api-openapi.yml

GENERATED

X General Api Phrasing Overlay

2 actions · phrasing · x-general-api-openapi.yml

GENERATED

X Lists Api Phrasing Overlay

10 actions · phrasing · x-lists-api-openapi.yml

GENERATED

X Media Api Phrasing Overlay

12 actions · phrasing · x-media-api-openapi.yml

GENERATED

X News Api Phrasing Overlay

3 actions · phrasing · x-news-api-openapi.yml

GENERATED

X Posts Api Phrasing Overlay

20 actions · phrasing · x-posts-api-openapi.yml

GENERATED

X Spaces Api Phrasing Overlay

7 actions · phrasing · x-spaces-api-openapi.yml

GENERATED

X Stream Api Phrasing Overlay

19 actions · phrasing · x-stream-api-openapi.yml

GENERATED

X Trends Api Phrasing Overlay

4 actions · phrasing · x-trends-api-openapi.yml

GENERATED

X Usage Api Phrasing Overlay

3 actions · phrasing · x-usage-api-openapi.yml

GENERATED

X Users Api Phrasing Overlay

45 actions · phrasing · x-users-api-openapi.yml

GENERATED

X Webhooks Api Phrasing Overlay

9 actions · phrasing · x-webhooks-api-openapi.yml

GENERATED

Scroll for all 24

Security Posture 3

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

X Authentication

http/oauth2 · 3 schemes

SECURITY

X Domain Security

HSTS

SECURITY

X Vulnerability Disclosure

Hackerone

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

X Scopes

29 scopes · authorizationCode

29 scopes

SCOPES

Agentic Access (API Evangelist recommendations) 1

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

X Agentic Access

198 operations · 88 acting · 4 human-in-the-loop

198 operations · 88 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

Sandbox

DeveloperPortal

GettingStarted

SignUp

Documentation 4

Reference material describing how the API behaves

OpenAPI

Documentation

APIReference

AIPreferences

Agent Surfaces 6

MCP servers, agent skills, and machine-readable catalogs

AgentSkill

AgenticAccess

MCPServer

AgentSkill

LLMsTxt

WellKnown

Design & Contract 8

Pagination, idempotency, versioning, errors, and events

Components

Conformance

ErrorCatalog

Conventions

Idempotency

DataModel

Webhooks

Lifecycle

Scroll for all 8

Build 6

SDKs, sample code, and the tooling you integrate with

Packages

SDKs

CLI

ToolCrosswalk

GitHubOrganization

GitHubOrganization

Postman

Postman

Access & Security 6

Authentication, authorization, and security posture

Authentication

OAuthScopes

SecurityTxt

DomainSecurity

VulnerabilityDisclosure

VulnerabilityDisclosure

Security

Security

Operate 6

Status, limits, changes, and where to get help

ChangeLog

RateLimits

Support

StatusPage

Deprecation

DeprecationSchedule

DeprecationSchedule

Commercial 7

Pricing, plans, and the legal terms of use

Plans

FinOps

Pricing

TermsOfService

PrivacyPolicy

UsageTerms

DataLicense

Scroll for all 7

Company 1

The organization behind the API

Website

Website

Other 5

Properties that don't map to a standard resource type

CapabilityMap

AgentCard

Overlay

DataProcessing

Eligibility

Source (apis.yml)

aid: x
name: X
description: X (formerly Twitter) operates the X Developer Platform, the programmable interface to the public conversation
  on X. The X API v2 is a 190-operation REST surface covering Posts, Users, Direct Messages, the encrypted Chat API, Lists,
  Spaces, Media, Communities, Community Notes, Broadcasts, News, Trends, Articles and Bots, plus a substantial real-time layer
  — filtered stream, firehose and sample volume streams, compliance streams, Account Activity webhooks and the X Activity
  API. X publishes a machine-readable OpenAPI at api.x.com/2/openapi.json, an llms.txt family, an AGENTS.md, an agentskills.io
  skill, an A2A agent card and two hosted MCP servers. Access is sold pay-per-usage in prepaid credits rather than by subscription
  tier, with an Enterprise agreement for volume above the published cap.
type: Index
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Pay-per-usage credits · Self-serve signup
  confidence: high
  source:
  - plans
  generated: '2026-08-28'
  method: searched
  note: X publishes no free tier for the X API v2. Access is prepaid credits consumed per resource read and per write request;
    the previous freemium classification came from a scaffolded plans file that has since been replaced with X's published
    pricing.
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/x.png
tags:
- Spaces
- Conversations
- X
- Social
- Social Media
- Posts
- User
- Direct Messages
- Streaming
- Webhook
- Real-Time
- Trends
- Media
- Content
- Agents
- MCP
- A2A
tags_raw:
- Spaces
- Conversation
- X
- Social
- Social Media
- Posts
- Users
- Direct Messages
- Streaming
- Webhooks
- Real Time
- Trends
- Media
- Spaces
- Content
- Conversation
- Agents
- MCP
- Social-Media
- A2A
created: '2025-08-14'
modified: '2026-08-28'
url: https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/apis.yml
specificationVersion: '0.23'
common:
- type: CapabilityMap
  url: capabilities/x-capability-edges.yml
  name: X Business Capability Map
- type: AgentSkill
  url: skills/x-x-skill.md
- type: Website
  url: https://x.com/
- type: OpenAPI
  url: openapi/_original/x-api-v2-openapi.json
- type: Authentication
  url: authentication/x-authentication.yml
- type: OAuthScopes
  url: scopes/x-scopes.yml
- type: AgenticAccess
  url: agentic-access/x-agentic-access.yml
- type: Packages
  url: packages/x-packages.yml
- type: SDKs
  url: packages/x-packages.yml
- type: CLI
  url: cli/x-cli.yml
- type: Components
  url: components/x-components.yml
- type: Sandbox
  url: sandbox/x-sandbox.yml
- type: MCPServer
  url: mcp/x-mcp.yml
- type: ToolCrosswalk
  url: mcp/x-tool-crosswalk.yml
- type: AgentCard
  url: a2a/x-a2a.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/x-llms.txt
- type: WellKnown
  url: well-known/x-well-known.yml
- type: SecurityTxt
  url: well-known/x-security.txt
- type: Conformance
  url: conformance/x-conformance.yml
- type: ErrorCatalog
  url: errors/x-problem-types.yml
- type: Conventions
  url: conventions/x-conventions.yml
- type: Idempotency
  url: conventions/x-conventions.yml
- type: DataModel
  url: data-model/x-data-model.yml
- type: Webhooks
  url: asyncapi/x-webhooks.yml
- type: Lifecycle
  url: lifecycle/x-lifecycle.yml
- type: ChangeLog
  url: changelog/x-changelog.yml
- type: Overlay
  url: overlays/x-api-v2-overlay.yaml
- type: Plans
  url: plans/x-plans-pricing.yml
- type: RateLimits
  url: rate-limits/x-rate-limits.yml
- type: FinOps
  url: finops/x-finops.yml
- type: DomainSecurity
  url: security/x-domain-security.yml
- type: VulnerabilityDisclosure
  url: security/x-vulnerability-disclosure.yml
- type: Security
  url: security/x-vulnerability-disclosure.yml
- 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/x-api/getting-started/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: StatusPage
  url: https://developer.x.com/status
- type: Deprecation
  url: https://docs.x.com/x-api/fundamentals/versioning
- type: Postman
  url: https://www.postman.com/xapidevelopers/x-api-public-workspace/collection/34902927-2efc5689-99c6-4ab6-8091-996f35c2fd80
- type: UsageTerms
  url: terms/x-terms-of-service.yml
- type: DataProcessing
  url: privacy/x-privacy-policy.yml
- type: DeprecationSchedule
  url: deprecation/x-deprecation-policy.yml
- type: Eligibility
  url: eligibility/x-eligibility.yml
- type: AIPreferences
  url: ai-preferences/x-ai-preferences.yml
- type: DataLicense
  url: data-license/x-data-license.yml
apis:
- aid: x:x-account-activity-api
  name: X Account Activity API
  description: Endpoints relating to retrieving, managing Account Activity subscriptions — 5 operation(s) in the X-published
    contract.
  humanURL: https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
  baseURL: https://api.x.com
  tags:
  - Account Activity
  properties:
  - type: OpenAPI
    url: openapi/x-account-activity-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
- aid: x:x-account-api
  name: X Account API
  description: Endpoints for managing the authenticated user's X Developer Platform account — 2 operation(s) in the X-published
    contract.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Account
  properties:
  - type: OpenAPI
    url: openapi/x-account-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
- aid: x:x-activity-api
  name: X Activity API
  description: Endpoints relating to retrieving, managing activity subscriptions — 5 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
  baseURL: https://api.x.com
  tags:
  - Activity
  properties:
  - type: OpenAPI
    url: openapi/x-activity-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
- aid: x:x-articles-api
  name: X Articles API
  description: Endpoints related to retrieving, creating & modifying Articles — 2 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/articles/introduction
  baseURL: https://api.x.com
  tags:
  - Articles
  properties:
  - type: OpenAPI
    url: openapi/x-articles-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/articles/introduction
- aid: x:x-bots-api
  name: X Bots API
  description: The Bots surface of the X API v2. — 6 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags:
  - Bots
  properties:
  - type: OpenAPI
    url: openapi/x-bots-api-openapi.yml
- aid: x:x-broadcasts-api
  name: X Broadcasts API
  description: Endpoints related to live broadcasts and their chat — 13 operation(s) in the X-published contract.
  humanURL: https://developer.x.com/
  baseURL: https://api.x.com
  tags:
  - Broadcast
  tags_raw:
  - Broadcasts
  properties:
  - type: OpenAPI
    url: openapi/x-broadcasts-api-openapi.yml
  - type: Documentation
    url: https://developer.x.com/
- aid: x:x-chat-api
  name: X Chat API
  description: Endpoints related to Chat encrypted messaging — 16 operation(s) in the X-published contract.
  humanURL: https://developer.x.com/
  baseURL: https://api.x.com
  tags:
  - Chat
  properties:
  - type: OpenAPI
    url: openapi/x-chat-api-openapi.yml
  - type: Documentation
    url: https://developer.x.com/
- aid: x:x-communities-api
  name: X Communities API
  description: Endpoints related to retrieving and managing Communities — 2 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/communities/introduction
  baseURL: https://api.x.com
  tags:
  - Community
  tags_raw:
  - Communities
  properties:
  - type: OpenAPI
    url: openapi/x-communities-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/communities/introduction
- aid: x:x-community-notes-api
  name: X Community Notes API
  description: Endpoints related to retrieving, searching, and modifying Community Notes — 5 operation(s) in the X-published
    contract.
  humanURL: https://docs.x.com/x-api/community-notes/introduction
  baseURL: https://api.x.com
  tags:
  - Community Notes
  properties:
  - type: OpenAPI
    url: openapi/x-community-notes-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/community-notes/introduction
- aid: x:x-compliance-api
  name: X Compliance API
  description: Endpoints related to keeping X data in your systems compliant — 6 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/compliance/batch-compliance/introduction
  baseURL: https://api.x.com
  tags:
  - Compliance
  properties:
  - type: OpenAPI
    url: openapi/x-compliance-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/compliance/batch-compliance/introduction
- aid: x:x-connections-api
  name: X Connections API
  description: Endpoints related to streaming connections — 4 operation(s) in the X-published contract.
  humanURL: https://developer.x.com/en/docs/x-api/connections
  baseURL: https://api.x.com
  tags:
  - Connections
  properties:
  - type: OpenAPI
    url: openapi/x-connections-api-openapi.yml
  - type: Documentation
    url: https://developer.x.com/en/docs/x-api/connections
- aid: x:x-direct-messages-api
  name: X Direct Messages API
  description: Endpoints related to retrieving, managing Direct Messages — 9 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/direct-messages/introduction
  baseURL: https://api.x.com
  tags:
  - Direct Messages
  properties:
  - type: OpenAPI
    url: openapi/x-direct-messages-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/direct-messages/introduction
- aid: x:x-general-api
  name: X General API
  description: Miscellaneous endpoints for general API functionality — 1 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/introduction
  baseURL: https://api.x.com
  tags: []
  tags_raw:
  - General
  properties:
  - type: OpenAPI
    url: openapi/x-general-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/introduction
- aid: x:x-lists-api
  name: X Lists API
  description: Endpoints related to retrieving, managing Lists — 9 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/lists/introduction
  baseURL: https://api.x.com
  tags:
  - List
  tags_raw:
  - Lists
  properties:
  - type: OpenAPI
    url: openapi/x-lists-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/lists/introduction
- aid: x:x-media-api
  name: X Media API
  description: Endpoints related to retrieving and uploading Media — 11 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/media/introduction
  baseURL: https://api.x.com
  tags:
  - Media
  properties:
  - type: OpenAPI
    url: openapi/x-media-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/media/introduction
- aid: x:x-news-api
  name: X News API
  description: Endpoint for retrieving news stories — 2 operation(s) in the X-published contract.
  humanURL: https://developer.x.com/
  baseURL: https://api.x.com
  tags:
  - News
  properties:
  - type: OpenAPI
    url: openapi/x-news-api-openapi.yml
  - type: Documentation
    url: https://developer.x.com/
- aid: x:x-posts-api
  name: X Posts API
  description: Endpoints related to retrieving, searching, and modifying Posts — 14 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/posts/introduction
  baseURL: https://api.x.com
  tags:
  - Posts
  properties:
  - type: OpenAPI
    url: openapi/x-posts-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/posts/introduction
  - type: OpenCollection
    url: collections/x-posts-api.opencollection.json
  - type: PostmanCollection
    url: collections/x-posts-api.postman_collection.json
- aid: x:x-spaces-api
  name: X Spaces API
  description: Endpoints related to retrieving, managing Spaces — 6 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/spaces/introduction
  baseURL: https://api.x.com
  tags:
  - Spaces
  tags_raw:
  - Spaces
  properties:
  - type: OpenAPI
    url: openapi/x-spaces-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/spaces/introduction
- aid: x:x-stream-api
  name: X Stream API
  description: Endpoints related to streaming — 18 operation(s) in the X-published contract.
  humanURL: https://developer.x.com/
  baseURL: https://api.x.com
  tags:
  - Stream
  properties:
  - type: OpenAPI
    url: openapi/x-stream-api-openapi.yml
  - type: Documentation
    url: https://developer.x.com/
- aid: x:x-trends-api
  name: X Trends API
  description: Endpoint for retrieving trends — 2 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/trends/introduction
  baseURL: https://api.x.com
  tags:
  - Trends
  properties:
  - type: OpenAPI
    url: openapi/x-trends-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/trends/introduction
  - type: OpenCollection
    url: collections/x-trends-api.opencollection.json
  - type: PostmanCollection
    url: collections/x-trends-api.postman_collection.json
- aid: x:x-usage-api
  name: X Usage API
  description: Endpoints related to retrieving usage — 2 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/usage/introduction
  baseURL: https://api.x.com
  tags:
  - Usage
  properties:
  - type: OpenAPI
    url: openapi/x-usage-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/usage/introduction
- aid: x:x-users-api
  name: X Users API
  description: Endpoints related to retrieving, managing relationships of Users — 42 operation(s) in the X-published contract.
  humanURL: https://docs.x.com/x-api/users/introduction
  baseURL: https://api.x.com
  tags:
  - User
  tags_raw:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/x-users-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/users/introduction
  - type: OpenCollection
    url: collections/x-users-api.opencollection.json
  - type: PostmanCollection
    url: collections/x-users-api.postman_collection.json
- aid: x:x-webhooks-api
  name: X Webhooks API
  description: Endpoints relating to retrieving, managing webhooks and webhook configs — 8 operation(s) in the X-published
    contract.
  humanURL: https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
  baseURL: https://api.x.com
  tags:
  - Webhook
  tags_raw:
  - Webhooks
  properties:
  - type: OpenAPI
    url: openapi/x-webhooks-api-openapi.yml
  - type: Documentation
    url: https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
- aid: x: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
  tags:
  - Advertising
  - Campaigns
  - Analytics
  - Audiences
  - Creative
  tags_raw:
  - Advertising
  - Campaigns
  - Analytics
  - Audiences
  - Creatives
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
x-enrichment:
  date: '2026-08-28'
  status: enriched
  artifacts_added: 49
  pass: local-v1
x-tags-removed:
- Space
x-a2a:
  verified: true
  probed: '2026-09-26'
  url: https://docs.x.com/.well-known/agent-card.json
  grade: conformant
  protocol_version: '0.3'
  control: 404

X API — frequently asked questions

Does X have an API?

Yes. APIs.io lists 24 APIs from X, including X Account Activity API, X Account API and X Activity API, and 21 more.

Is there an OpenAPI specification for the X API?

Yes. APIs.io indexes 23 OpenAPI specifications for X, each linked for download from this page.

How do I authenticate with the X API?

X documents its authentication (http/oauth2 · 3 schemes). The details are profiled on APIs.io as X Authentication.

How much does the X API cost?

X publishes its prices; its Posts: Read plan is $0.005 per resource as of 2026-10-28. APIs.io lists 7 pricing plans for X, with each plan's price, limits and inclusions under Pricing on this page.

Does X have an MCP server?

Yes. APIs.io lists 1 MCP server for X: X ships TWO hosted MCP servers: an API server at https://api.x.com/mcp that calls X API v2 endpoints, and a documentation-search server at https://docs.x.com/mcp. Both are Streamable HTTP remote endpo

Is the X API ready for AI agents?

X has a Kin Score of 75.0 out of 100 (exemplar) and an Agent Readiness score of 61.2 (agent-native), scored by API Evangelist on 2026-11-13.

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/x"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/x/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/x/evidence"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.