> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Filtered Stream
> Recibe Posts casi en tiempo real que coincidan con reglas personalizadas con X API v2 Filtered Stream, usando operadores potentes para filtrar el firehose público de Posts.
export const Button = ({href, children}) => {
return ;
};
Los endpoints de Filtered Stream te permiten recibir Posts casi en tiempo real que coincidan con tus reglas de filtrado. Crea reglas usando operadores potentes y luego conéctate a un stream persistente para recibir Posts coincidentes a medida que se publican.
Filtered Stream prioriza la hidratación y entrega de datos, con aproximadamente 6-7 segundos de latencia P99. Para requisitos de latencia más baja, consulta [Powerstream](/x-api/powerstream/introduction).
## Descripción general
Recibe Posts en segundos tras su publicación
Añade y elimina reglas sin desconectarte
Coincide con palabras clave, hashtags, usuarios y más
Opcionalmente recibe Posts a través de webhooks
***
## Cómo funciona
1. **Crear reglas** — define reglas de filtrado usando operadores
2. **Conectarse al stream** — establece una conexión HTTP persistente
3. **Recibir Posts** — obtén Posts coincidentes casi en tiempo real
```mermaid actions={false} theme={null}
flowchart LR
A["Crear/gestionar
reglas"] --> B["Conectarse al
endpoint de streaming"] --> C["Recibir
Posts coincidentes"]
```
***
## Endpoints
| Method | Endpoint | Description |
| :----- | :------------------------------------------------------------------- | :------------------------ |
| GET | [`/2/tweets/search/stream`](/x-api/stream/stream-filtered-posts) | Conéctate al stream |
| POST | [`/2/tweets/search/stream/rules`](/x-api/stream/update-stream-rules) | Añade o elimina reglas |
| GET | [`/2/tweets/search/stream/rules`](/x-api/stream/get-stream-rules) | Lista las reglas actuales |
***
## Niveles de acceso
| Feature | Pay-per-use | Enterprise |
| :-------------------------------- | :--------------- | :-------------------------- |
| Reglas por proyecto | 1,000 | 25,000+ |
| Longitud de regla | 1,024 caracteres | 2,048 caracteres |
| Conexiones | 1 | Múltiples |
| Operadores Core | ✓ | ✓ |
| Operadores de embedding semántico | — | ✓ (requiere Embedding tier) |
Obtén límites más altos y funciones adicionales
Algunos operadores requieren niveles específicos. El operador semántico `embedding:` está disponible **solo para Filtered Stream** en planes Enterprise con acceso al Embedding tier. El acceso Pay-per-use estándar incluye solo operadores core.
***
## Construir reglas
Las reglas usan los mismos operadores que las consultas de búsqueda:
```
(AI OR "machine learning") lang:en -is:retweet
```
### Ejemplos de reglas
| Rule | Matches |
| :---------------------------------- | :------------------------------------------------------------------------------ |
| `#python` | Posts con el hashtag #python |
| `from:elonmusk` | Posts de @elonmusk |
| `"breaking news" has:images` | Posts con la frase e imágenes |
| `(@XDevelopers OR @X) -is:retweet` | Menciones, excluyendo retweets |
| `embedding:"climate change policy"` | Posts sobre política climática de forma semántica (Enterprise + Embedding tier) |
Aprende la sintaxis y los operadores de las reglas
***
## Conectarse al stream
Establece una conexión HTTP persistente para recibir Posts:
```python theme={null}
import requests
def stream_posts(bearer_token):
url = "https://api.x.com/2/tweets/search/stream"
headers = {"Authorization": f"Bearer {bearer_token}"}
response = requests.get(url, headers=headers, stream=True)
for line in response.iter_lines():
if line:
print(line.decode("utf-8"))
```
### Señales de keep-alive
El stream envía líneas en blanco (`\r\n`) cada 20 segundos para mantener la conexión. Si no recibes datos o un keep-alive durante 20 segundos, vuelve a conectarte.
Reconéctate de forma controlada
Procesa Posts de forma eficiente
***
## Entrega por webhook
En lugar de mantener una conexión persistente, puedes recibir Posts a través de webhooks:
Configura la entrega por webhook para filtered stream
***
## Ediciones de Post
El stream entrega Posts editados con su historial de edición. Cada edición crea un nuevo ID de Post:
```json theme={null}
{
"data": {
"id": "1234567893",
"text": "Hello world! (edited)",
"edit_history_tweet_ids": ["1234567890", "1234567891", "1234567893"]
}
}
```
Aprende más sobre las ediciones de Posts
***
## Cómo empezar
**Requisitos previos**
* Una [cuenta de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info) aprobada
* Un [Project y App](/resources/fundamentals/developer-apps) en la Developer Console
* El [Bearer Token](/resources/fundamentals/authentication) de tu App
Conéctate al stream en minutos
Aprende la sintaxis de las reglas
Todos los operadores disponibles
Ejemplos de código funcional
***
## Temas avanzados
Reconéctate de forma controlada
Maneja un alto rendimiento
Construye aplicaciones resilientes
Identifica qué reglas coincidieron