Quickstart de Recent Search

Esta guía te muestra cómo hacer tu primera solicitud de recent search para encontrar Posts de los últimos 7 días.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
El Bearer Token de tu App (que se encuentra en la Developer Console en “Keys and tokens”)

Construye una consulta

Las consultas de búsqueda usan operadores para coincidir con Posts. Comienza con una palabra clave sencilla:

python

O combina múltiples operadores:

python lang:en -is:retweet

Esto coincide con Posts que contienen “python” en inglés, excluyendo los retweets.

Consulta la referencia completa de operadores para todas las opciones disponibles.

Realiza una solicitud

cURL

curl "https://api.x.com/2/tweets/search/recent?query=python%20lang%3Aen%20-is%3Aretweet" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Busca Posts recientes
for page in client.posts.search_recent(
    query="python lang:en -is:retweet"
):
    for post in page.data:
        print(post.text)

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Busca Posts recientes
const paginator = client.posts.searchRecent({
  query: "python lang:en -is:retweet",
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

Revisa la respuesta

La respuesta predeterminada incluye id, text y edit_history_tweet_ids:

{
  "data": [
    {
      "id": "1234567890123456789",
      "text": "Just started learning Python and loving it!",
      "edit_history_tweet_ids": ["1234567890123456789"]
    },
    {
      "id": "1234567890123456788",
      "text": "Python tip: use list comprehensions for cleaner code",
      "edit_history_tweet_ids": ["1234567890123456788"]
    }
  ],
  "meta": {
    "newest_id": "1234567890123456789",
    "oldest_id": "1234567890123456788",
    "result_count": 2
  }
}

Añade fields y expansions

Solicita datos adicionales con parámetros de consulta:

cURL

curl "https://api.x.com/2/tweets/search/recent?\
query=python%20lang%3Aen%20-is%3Aretweet&\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Búsqueda con fields y expansions
for page in client.posts.search_recent(
    query="python lang:en -is:retweet",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Likes: {post.public_metrics.like_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Búsqueda con fields y expansions
const paginator = client.posts.searchRecent({
  query: "python lang:en -is:retweet",
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
  maxResults: 10,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text?.slice(0, 50)}... - Likes: ${post.public_metrics?.like_count}`);
  });
}

Respuesta:

Ejemplo de respuesta

{
  "data": [
    {
      "id": "1234567890123456789",
      "text": "Just started learning Python and loving it!",
      "created_at": "2024-01-15T10:30:00.000Z",
      "author_id": "9876543210",
      "public_metrics": {
        "retweet_count": 5,
        "reply_count": 2,
        "like_count": 42,
        "quote_count": 1
      },
      "edit_history_tweet_ids": ["1234567890123456789"]
    }
  ],
  "includes": {
    "users": [
      {
        "id": "9876543210",
        "username": "pythondev",
        "verified": false
      }
    ]
  },
  "meta": {
    "newest_id": "1234567890123456789",
    "oldest_id": "1234567890123456789",
    "result_count": 1
  }
}

Pagina los resultados

Los SDKs manejan la paginación automáticamente. Para cURL, usa el next_token de la respuesta:

curl "https://api.x.com/2/tweets/search/recent?\
query=python&\
max_results=100&\
next_token=b26v89c19zqg8o3fo7gesq314yb9l2l4ptqy" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Guía de paginación

Aprende más sobre cómo navegar por conjuntos de resultados grandes

Ejemplos de consultas

Posts de un usuario específico

from:XDevelopers

Posts con un hashtag

#Python -is:retweet

Posts con imágenes

"machine learning" has:images lang:en

Posts que mencionan a un usuario

@elonmusk -is:retweet -is:reply

Posts con enlaces a un dominio

url:github.com lang:en

Próximos pasos

Construir una consulta

Domina la sintaxis y los operadores de consulta

Referencia de operadores

Consulta todos los operadores disponibles

Full-archive search

Busca en el archivo completo de Posts

Referencia de la API

Documentación completa del endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Quickstart de Recent Search

Guía de paginación

Ejemplos de consultas

Próximos pasos

Construir una consulta

Referencia de operadores

Full-archive search

Referencia de la API

Guía de paginación

​Ejemplos de consultas

​Próximos pasos

Construir una consulta

Referencia de operadores

Full-archive search

Referencia de la API

Ejemplos de consultas

Próximos pasos