Inicio rápido de búsqueda reciente

Esta guía te explica cómo realizar tu primera solicitud de búsqueda reciente para encontrar Publicaciones 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 (se encuentra en la Consola de desarrollador en “Keys and tokens”)

Crear una consulta

Las consultas de búsqueda utilizan operadores para encontrar Publicaciones. Comienza con una palabra clave sencilla:

python

O bien combina varios operadores:

python lang:en -is:retweet

Esto coincide con las Publicaciones que contienen “python” en inglés y excluye los retweets.

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

Realizar 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")

# Buscar publicaciones 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" });

// Buscar publicaciones 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);
  });
}

Revisar la respuesta

De forma predeterminada, la respuesta 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
  }
}

Agregar campos y expansions

Solicita datos adicionales usando 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 campos 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]}... - Me gusta: {post.public_metrics.like_count}")

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

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

// Búsqueda con campos 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)}... - Me gusta: ${post.public_metrics?.like_count}`);
  });
}

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

Paginar resultados

Los SDK gestionan la paginación automáticamente. Para cURL, utiliza 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

Más información sobre cómo explorar grandes conjuntos de resultados

Consultas de ejemplo

Publicaciones de un usuario específico

from:XDevelopers

Publicaciones con un hashtag

#Python -is:retweet

Publicaciones con imágenes

"machine learning" has:images lang:en

Publicaciones que mencionan a un usuario

@elonmusk -is:retweet -is:reply

Publicaciones con enlaces a un dominio

url:github.com lang:en

Próximos pasos

Crear una consulta

Domina la sintaxis de las consultas y los operadores

Referencia de operadores

Consulta todos los operadores disponibles

Búsqueda en el archivo completo

Busca en el archivo completo de Publicaciones

Referencia de la API

Documentación completa del endpoint

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Inicio rápido de búsqueda reciente

Guía de paginación

Consultas de ejemplo

Próximos pasos

Crear una consulta

Referencia de operadores

Búsqueda en el archivo completo

Referencia de la API

Guía de paginación

​Consultas de ejemplo

​Próximos pasos

Crear una consulta

Referencia de operadores

Búsqueda en el archivo completo

Referencia de la API

Consultas de ejemplo

Próximos pasos