x/
trends

Aktuelle öffentliche X-Trends zu einer oder mehreren numerischen WOEIDs erfassen – mit Rang in der Quelle, Abfrage, Beschreibung, Standortkontext und Erfassungszeitpunkt.

X Trends API

WOEID-Momentaufnahmen
Rang in der Quelle
Standortkontext
0,5 Credits pro Ergebnis
Bereit
README

Von SocQ · Aktualisiert am

X Trends

X-Trends sind eine nach Standort geordnete Momentaufnahme öffentlicher Themen, die für eine numerische WOEID verfügbar sind, wobei Quellname, Rang, Abfrage, Beschreibung und Erfassungszeitpunkt zusammenbleiben. Diese Struktur unterstützt die regionale Themenentdeckung und wiederholte Beobachtung und macht zugleich deutlich, dass jeder Datensatz den Erfassungszeitpunkt widerspiegelt und keine historische Trendreihe darstellt.

Funktionen der X Trends API

  • Erfassung nach StandortFordern Sie die aktuellen öffentlichen Trends für eine oder mehrere bekannte numerische WOEIDs an und behalten Sie die ursprüngliche Kennung in extra.woeid bei.
  • Rang der Quelle bleibt erhaltenBehält den Rang der vorgelagerten Quelle in metrics.rank bei, sofern er verfügbar ist, und ersetzt ihn nicht durch einen von SocQ berechneten Wert.
  • Nützlicher TrendkontextSie erhalten den Trendnamen mit der Abfrage der vorgelagerten Quelle und der Beschreibung des Anbieters, sofern diese Felder bereitgestellt werden.
  • Unabhängige Obergrenzen pro StandortWendet results_limit getrennt auf jede übergebene WOEID an und erfasst dabei die aktuell verfügbare Trendmenge jedes Standorts einmal.

Parameter der X Trends API

ParameterErforderlichBeschreibung
woeidsErforderlichErforderliches Array mit einer oder mehreren bekannten X-Standortkennungen, jeweils als nicht leere numerische Zeichenfolge dargestellt.
results_limitOptionalOptionale ganzzahlige Obergrenze, die getrennt auf jede WOEID angewendet wird. Standard ist 100; zulässig sind Werte von 20 bis 2.000.

So verwenden Sie die X Trends API

Beginnen Sie mit numerischen WOEIDs, die Sie bereits kennen, wählen Sie eine Obergrenze pro Standort und behandeln Sie die zurückgegebenen Datensätze als Momentaufnahme zum Erfassungszeitpunkt.

  1. Geben Sie eine oder mehrere bekannte WOEIDs als numerische Zeichenfolgen ein; dieser Endpunkt löst keine Ortsnamen auf.
  2. Wählen Sie ein ganzzahliges results_limit von 20 bis 2.000 oder behalten Sie den Standardwert von 100 pro WOEID bei.
  3. Senden Sie die Anfrage per POST an /v1/x/trends und fragen Sie dann /v1/tasks/{task_id} ab, bis die Aufgabe succeeded erreicht.
  4. Lesen Sie data.results.items und folgen Sie dem next_cursor des Aufgabenergebnisses, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/x/trends" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"woeids":["1"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der X Trends API

  • Themen in einem bekannten Markt beobachten: Erfassen Sie die aktuellen Namen, Ränge und Beschreibungen zu einer Standortkennung, die Ihr Monitoring-System ohnehin pflegt.
  • Wiederkehrende Beobachtungs-Momentaufnahmen aufbauen: Führen Sie dieselbe WOEID nach einem Zeitplan aus, den Sie selbst steuern, und speichern Sie collected_at bei jedem Ergebnis für spätere Änderungsanalysen.
  • Eine Warteschlange für die Themenprüfung erstellen: Nutzen Sie Name, Abfrage, Rang und Beschreibung der Ergebnisse, um öffentliche Themen für die Prüfung durch Analysten oder einen nachgelagerten Entdeckungs-Workflow zu priorisieren.

Profi-Tipps zur X Trends API

  • Halten Sie numerische WOEIDs bereit, bevor Sie eine Aufgabe senden; Ortsnamen und frei formulierte Standorte werden nicht akzeptiert.
  • Der vorgegebene Standardwert 1 folgt dem veröffentlichten Anfragebeispiel des Backends; ersetzen Sie ihn durch die Kennung, die zu Ihrem beabsichtigten Umfang passt.
  • Verstehen Sie results_limit als Obergrenze pro WOEID, denn eine aktuelle Trendmenge kann weniger Zeilen enthalten als angefordert.
  • Führen Sie sich überschneidende Standorte in getrennten Aufgaben aus, wenn jede Zuordnung von Trend zu Standort erhalten bleiben soll, denn identische Trendnamen können innerhalb einer Aufgabe dedupliziert werden.
  • Verwenden Sie collected_at als Beobachtungszeitpunkt; created_at ist null, weil die Quelle keinen Erstellungszeitstempel für Trends bereitstellt.
  • Cursor der Aufgabenergebnisse blättern durch bereits gespeicherte Datensätze und fordern beim Anbieter keine weitere Trendseite an.

Ergänzend zur X Trends API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher X-Daten benötigen.

  • Twitter Tweet Scraper API — Öffentliche Post-Texte, Autoren, Interaktionen, Medien, Hashtags, Erwähnungen und Gesprächsbeziehungen aus Status-URLs von x.com oder twitter.com abrufen.
  • Twitter Profile Scraper API — Öffentliche Kontoidentität, Bios, Avatare, Titelbilder, Kontostatus und sichtbare Statistiken zur Zielgruppe per Benutzername abrufen.
  • Twitter User Tweets Scraper API — Aktuelle öffentliche Posts, Autoren, Medien, Hashtags, Erwähnungen und Interaktionen per Benutzername erfassen – ohne Antworten.
  • Twitter Search API — Öffentliche Posts per Suchausdruck finden – mit Sortierung nach neuesten oder beliebtesten Posts und konfigurierbarem Ergebnislimit.
  • Twitter User Search API — Öffentliche X-Konten per Keyword finden.
  • X Communities Search API — Communities per Stichwort finden – mit Mitgliederzahl und einem Link für die Mitglieder- und Post-Endpunkte.

Weitere Plattformen entdecken

Kombinieren Sie X-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

X Trends API — FAQ

X Trends API ist eine Schnittstelle zum Erfassen aktueller öffentlicher X-Trend-Momentaufnahmen nach numerischer WOEID.

Übergeben Sie eine oder mehrere bekannte Standortkennungen als numerische Zeichenfolgen. Der Endpunkt übersetzt keinen Städte- oder Ländernamen in eine WOEID.

Es ist standardmäßig 100, akzeptiert ganze Zahlen von 20 bis 2.000 und wird getrennt auf jede WOEID angewendet. Die Quelle kann weniger aktuelle Trends bereitstellen als die angeforderte Obergrenze.

Ein Datensatz enthält den Trendnamen als id und text, einen Rang der vorgelagerten Quelle, sofern vorhanden, collected_at sowie extra-Felder für WOEID, Abfrage und Beschreibung, sofern verfügbar.

Nein. Er liefert für jede angeforderte WOEID eine aktuelle Momentaufnahme; einen Verlauf bauen Sie auf, indem Sie wiederholte Läufe in Ihrem eigenen System planen und speichern.

Gespeicherte Datensätze werden innerhalb einer Aufgabe anhand des normalisierten Trendnamens dedupliziert. Kommt derselbe Name in mehreren übergebenen Standorten vor, kann der zuerst gespeicherte Datensatz nur einen Wert in extra.woeid behalten.

Jeder erfolgreich gespeicherte normalisierte Trend kostet 0,5 SocQ-Credits. Die Schätzung nutzt results_limit für jede übergebene WOEID, und nicht genutzte, vorab belastete Credits werden erstattet, sobald die Aufgabe abgerechnet ist.