X

X Stream API

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

GitHub OpenAPI

Operations 18

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /2/activity/stream Stream X activity events · Activity Stream #
Ask an LLM
“Can I open a live stream of the activity events I've subscribed to?”
“Can the activity stream backfill events I missed during a disconnect?”
Tell an agent
Connect to my X activity stream.
Stream my subscribed activity events with {backfill_minutes} minutes of backfill.
GET /2/likes/compliance/stream Stream Likes compliance events · Stream Likes compliance data #
Ask an LLM
“Where do I get compliance events about Likes I've stored?”
“Can I replay Likes compliance data from a start time?”
Tell an agent
Stream Likes compliance data.
Stream Likes compliance events from {start_time} to {end_time}.
GET /2/likes/firehose/stream Stream every public Like · Stream all Likes #
Ask an LLM
“Is there a firehose of all public Likes in real time?”
“How is the full Likes firehose split into partitions?”
Tell an agent
Stream all public Likes on partition {partition}.
Connect to the full Likes firehose, partition {partition}, with {backfill_minutes} minutes of backfill.
GET /2/likes/sample10/stream Stream a 10% sample of Likes · Stream sampled Likes #
Ask an LLM
“Can I get a 10 percent sample of public Likes instead of the whole firehose?”
“Which partition should I read from the sampled Likes stream?”
Tell an agent
Stream the 10% Likes sample on partition {partition}.
Connect to sampled Likes, partition {partition}, starting {start_time}.
GET /2/tweets/compliance/stream Stream Posts compliance events · Stream Posts compliance data #
Ask an LLM
“Where do I receive compliance events for Posts I've stored?”
“Does the Posts compliance stream require a partition?”
Tell an agent
Stream Posts compliance data on partition {partition}.
Read Posts compliance events for partition {partition} from {start_time}.
GET /2/tweets/firehose/stream Stream every public Post in all languages · Stream all Posts #
Ask an LLM
“Is there a full firehose of every public Post in real time?”
“Can I backfill the all-language Posts firehose after a disconnect?”
Tell an agent
Stream the full all-language Posts firehose on partition {partition}.
Connect to every public Post, partition {partition}, with {backfill_minutes} minutes backfill.
GET /2/tweets/firehose/stream/lang/en Stream all English-language Posts · Stream English Posts #
Ask an LLM
“Can I get a firehose of only English-language Posts?”
“Which stream gives me every public Post written in English?”
Tell an agent
Stream English Posts on partition {partition}.
Connect to the English-language firehose for partition {partition}.
GET /2/tweets/firehose/stream/lang/ja Stream all Japanese-language Posts · Stream Japanese Posts #
Ask an LLM
“Can I get a firehose of only Japanese-language Posts?”
“Which stream gives me every public Post written in Japanese?”
Tell an agent
Stream Japanese Posts on partition {partition}.
Connect to the Japanese-language firehose for partition {partition}.
GET /2/tweets/firehose/stream/lang/ko Stream all Korean-language Posts · Stream Korean Posts #
Ask an LLM
“Can I get a firehose of only Korean-language Posts?”
“Which stream gives me every public Post written in Korean?”
Tell an agent
Stream Korean Posts on partition {partition}.
Connect to the Korean-language firehose for partition {partition}.
GET /2/tweets/firehose/stream/lang/pt Stream all Portuguese-language Posts · Stream Portuguese Posts #
Ask an LLM
“Can I get a firehose of only Portuguese-language Posts?”
“Which stream gives me every public Post written in Portuguese?”
Tell an agent
Stream Portuguese Posts on partition {partition}.
Connect to the Portuguese-language firehose for partition {partition}.
GET /2/tweets/label/stream Stream labels applied to Posts · Stream Post labels #
Ask an LLM
“How can I receive labeling events as they're applied to Posts?”
“Can I replay Post label events over a time window?”
Tell an agent
Stream Post labeling events.
Stream Post labels applied between {start_time} and {end_time}.
GET /2/tweets/sample/stream Stream a 1% sample of Posts · Stream sampled Posts #
Ask an LLM
“Is there a lightweight 1 percent sample stream of public Posts?”
“Can the 1% Posts sample include author details?”
Tell an agent
Connect to the 1% sampled Posts stream.
Stream the 1% Post sample with {backfill_minutes} minutes backfill.
GET /2/tweets/sample10/stream Stream a 10% sample of Posts · Stream 10% sampled Posts #
Ask an LLM
“Can I get a 10 percent sample of public Posts in real time?”
“Which partition do I read for the 10% Posts sample?”
Tell an agent
Stream the 10% Posts sample on partition {partition}.
Connect to the decahose-style 10% Post sample, partition {partition}, from {start_time}.
GET /2/tweets/search/stream Stream Posts matching my rules · Stream filtered Posts #
Ask an LLM
“Where do I receive Posts in real time that match my filtered-stream rules?”
“Can the filtered stream backfill Posts I missed while disconnected?”
Tell an agent
Connect to my filtered stream of Posts.
Stream rule-matching Posts with {backfill_minutes} minutes backfill.
GET /2/tweets/search/stream/rules List my filtered-stream rules · Get filtered-stream rules #
Ask an LLM
“Which filtered-stream rules are active for my app?”
“Can I fetch just specific stream rules by their IDs?”
Tell an agent
List my active filtered-stream rules.
Get stream rules {ids}.
POST /2/tweets/search/stream/rules Add or delete filtered-stream rules · Update stream rules #
Ask an LLM
“What call adds a new rule to my filtered stream?”
“Can I dry-run a rule change to validate it without committing?”
Tell an agent
Add filtered-stream rules {add}.
Delete stream rules {delete}.
GET /2/tweets/search/stream/rules/counts Count my filtered-stream rules · Get Rule Counts #
Ask an LLM
“How many filtered-stream rules do I have in place?”
“Can I see rule-count totals for my stream?”
Tell an agent
Show my filtered-stream rule counts.
Count the rules on my stream with fields {fields}.
GET /2/users/compliance/stream Stream Users compliance events · Stream Users compliance data #
Ask an LLM
“Where do I get compliance events for user accounts I've stored?”
“Which partition does the Users compliance stream need?”
Tell an agent
Stream Users compliance data on partition {partition}.
Read Users compliance events for partition {partition} since {start_time}.

Documentation

📖
Documentation
https://developer.x.com/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-stream-api-openapi.yml

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API 
curl "https://apis.io/api/v1/apis/x:x-stream-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

OpenAPI Specification

x-stream-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: X API v2 core endpoints
  version: '2.168'
  title: X API v2 Stream API
  termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
  contact:
    name: X Developers
    url: https://developer.x.com/
  license:
    name: X Developer Agreement and Policy
    url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
- description: X API
  url: https://api.x.com
tags:


# --- truncated at 32 KB (153 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-stream-api-openapi.yml