Datos históricos

Nota: consulta una comparación de métodos, exportación a CSV y más código en la guía de datos históricos de Twitter.

​

Endpoints

​

Búsqueda histórica por palabras clave

import requests, time

API_KEY = "YOUR_API_KEY"
URL = "https://api.sorsa.io/v3/search-tweets"

def search_archive(query, max_pages=50):
    all_tweets, next_cursor = [], None
    for _ in range(max_pages):
        body = {"query": query, "order": "latest"}
        if next_cursor:
            body["next_cursor"] = next_cursor

        resp = requests.post(
            URL,
            headers={"ApiKey": API_KEY, "Content-Type": "application/json"},
            json=body,
        )
        resp.raise_for_status()
        data = resp.json()

        all_tweets.extend(data.get("tweets", []))
        next_cursor = data.get("next_cursor")
        if not next_cursor:
            break
        time.sleep(0.1)
    return all_tweets


tweets = search_archive('"climate change" since:2015-06-01 until:2015-12-31 lang:en min_faves:10')

​

Cronología completa de una cuenta

resp = requests.post(
    "https://api.sorsa.io/v3/user-tweets",
    headers={"ApiKey": API_KEY, "Content-Type": "application/json"},
    json={"user_link": "https://x.com/naval"},
)

​

Datos que puedes recuperar

• Texto completo, sin recortes ni sustitución de URL.
• Las seis métricas: likes_count, retweet_count, reply_count, quote_count, view_count y bookmark_count.
• Objeto user con el perfil completo del autor.
• Array entities con URL multimedia (fotos, vídeos y GIF) y vistas previas de enlaces.
• Metadatos de conversación: conversation_id_str, in_reply_to_tweet_id, is_reply e is_quote_status.
• Código de idioma: lang.

​

Limitaciones de la plataforma

• Las publicaciones eliminadas desaparecen del índice de búsqueda y no se pueden recuperar.
• Las cuentas protegidas se excluyen de búsquedas y cronologías públicas.
• Los perfiles no son históricos. Una publicación de 2014 devuelve la biografía, el nombre y los seguidores actuales de su autor, no los de 2014.
• Las métricas no son instantáneas históricas. Los contadores de Me gusta, retuits y visualizaciones reflejan los totales actuales. Si necesitas valores de una fecha concreta, recopila y guarda las métricas mediante Supervisión en tiempo real.

​

Buenas prácticas

​

Divide los intervalos grandes

def monthly_chunks(year):
    out = []
    for month in range(1, 13):
        since = f"{year}-{month:02d}-01"
        nm = month + 1 if month < 12 else 1
        ny = year if month < 12 else year + 1
        until = f"{ny}-{nm:02d}-01"
        out.append((since, until))
    return out

for since, until in monthly_chunks(2020):
    tweets = search_archive(f'bitcoin since:{since} until:{until} lang:en min_faves:50')

​

Reduce el ruido de los retuits

​

Combina interacción y fechas

"product launch" since:2022-03-01 until:2022-03-31 min_faves:100 -filter:retweets lang:en

​

Divide los temas globales por idioma

​

Continúa hasta agotar el cursor

​

Guías relacionadas

• Búsqueda de publicaciones: referencia de /search-tweets.
• Operadores de búsqueda: diccionario completo.
• Paginación: cursores.
• Supervisión en tiempo real: combina la recuperación histórica con nuevas publicaciones.
• Seguimiento de menciones: menciones históricas de cuentas.
• Optimización del uso de la API: reduce solicitudes en recopilaciones grandes.