Inicio rápido

Configura suscripciones a flujos de actividad y recibe eventos

Esta guía te explica paso a paso cómo configurar suscripciones al flujo de actividad para recibir eventos de actividad de cuenta en tiempo real.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con una App aprobada
• El Bearer Token de tu App

---

1. Crear una suscripción

   Suscríbete a los eventos de actividad de un usuario:

   cURL

   curl -X POST "https://api.x.com/2/activity/subscriptions" \
     -H "Authorization: Bearer $BEARER_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"]
     }'
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/activity/subscriptions"
   headers = {
       "Authorization": f"Bearer {bearer_token}",
       "Content-Type": "application/json"
   }
   payload = {
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"]
   }
   
   response = requests.post(url, headers=headers, json=payload)
   print(response.json())
   

   Respuesta:

   {
     "data": {
       "id": "1234567890",
       "user_id": "2244994945",
       "event_types": ["tweet_create_events", "favorite_events", "follow_events"],
       "created_at": "2024-01-15T10:00:00.000Z"
     }
   }
   
2. Conectarse al stream

   Abre una conexión persistente para recibir eventos:

   cURL

   curl "https://api.x.com/2/activity/stream" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

   Python

   import requests
   
   bearer_token = "YOUR_BEARER_TOKEN"
   
   url = "https://api.x.com/2/activity/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"))
   
3. Procesar eventos entrantes

   Los eventos se transmiten como objetos JSON:

   {
     "for_user_id": "2244994945",
     "event_type": "tweet_create_events",
     "created_at": "2024-01-15T10:30:00.000Z",
     "tweet_create_events": [
       {
         "id": "1234567890",
         "text": "¡Hola desde el stream!",
         "author_id": "2244994945"
       }
     ]
   }
   

---

​

Tipos de eventos disponibles

Event	Description
tweet_create_events	El usuario publica una nueva Publicación
favorite_events	El usuario indica “Me gusta” en una Publicación
follow_events	El usuario sigue a otro usuario o es seguido por otro usuario
direct_message_events	El usuario envía o recibe un DM
block_events	El usuario bloquea o desbloquea
mute_events	El usuario silencia o deja de silenciar

---

​

Administrar suscripciones

Listar suscripciones

Obtén todas las suscripciones activas:

curl "https://api.x.com/2/activity/subscriptions" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Actualizar una suscripción

Modifica los tipos de eventos de una suscripción:

curl -X PUT "https://api.x.com/2/activity/subscriptions/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_types": ["tweet_create_events", "favorite_events"]
  }'

Eliminar una suscripción

Elimina una suscripción:

curl -X DELETE "https://api.x.com/2/activity/subscriptions/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Próximos pasos

Account Activity API

Alternativa basada en webhooks

Referencia de la API

Documentación completa de los endpoints