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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
woeids | Erforderlich | Erforderliches Array mit einer oder mehreren bekannten X-Standortkennungen, jeweils als nicht leere numerische Zeichenfolge dargestellt. |
results_limit | Optional | Optionale 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.
- Geben Sie eine oder mehrere bekannte WOEIDs als numerische Zeichenfolgen ein; dieser Endpunkt löst keine Ortsnamen auf.
- Wählen Sie ein ganzzahliges results_limit von 20 bis 2.000 oder behalten Sie den Standardwert von 100 pro WOEID bei.
- Senden Sie die Anfrage per POST an /v1/x/trends und fragen Sie dann /v1/tasks/{task_id} ab, bis die Aufgabe succeeded erreicht.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API