Twitter Search
Suchergebnisse auf X sind öffentliche Posts, die zu einer Abfrage ausgewählt wurden, und tragen Sprache, Autor, Medien, Entitäten, Gesprächskontext und sichtbare Interaktion jedes Treffers mit sich. Bleibt die Abfrage bei jedem Datensatz erhalten, lassen sich wiederkehrende Themenscans, die Beobachtung von Produktstarts und der Vergleich von Ergebnismengen leichter nachprüfen.
Funktionen der Twitter Search API
- Entdeckung ausgehend von einem AusdruckSenden Sie ein nicht leeres Stichwort oder einen Suchausdruck und machen Sie aus den passenden öffentlichen X-Posts strukturierte Datensätze.
- Sortierung für zwei RecherchemodiVerwenden Sie latest, um aktuelle Treffer zu verfolgen, oder top, um prominente Treffer zu prüfen; standardmäßig ist latest gewählt.
- Eine praxisgerechte Obergrenze für SuchergebnisseFordern Sie 20 bis 2.000 Ergebnisse in Schritten von 20 an, um die maximale Tiefe der Suchergebnis-Erfassung festzulegen.
- Treffer, die ihre Abfrage behaltenVerbinden Sie Text, Autor, Interaktion, Medien, Entitäten, Zeitstempel und Beziehungsfelder mit extra.search_query und collected_at.
Parameter der Twitter Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliches, nicht leeres Stichwort oder erforderlicher Suchausdruck für X-Posts, mit dem passende öffentliche Posts gefunden werden. |
results_limit | Optional | Optionale Obergrenze für die angeforderten Ergebnisse. Standard ist 20; zulässig sind Vielfache von 20 von 20 bis 2.000. |
sort_by | Optional | Optionale Sortierung mit latest für aktuelle Treffer oder top für prominente Treffer. Standard ist latest. |
So verwenden Sie die Twitter Search API
Formulieren Sie eine präzise Rechercheaufgabe als Suchausdruck, wählen Sie die passende Sortierung und bewahren Sie die Abfrage zusammen mit den resultierenden Posts auf.
- Schreiben Sie einen gezielten, nicht leeren Ausdruck für die X-Posts, die Sie finden möchten.
- Wählen Sie latest oder top und legen Sie ein results_limit von 20 bis 2.000 in Schritten von 20 fest.
- Senden Sie die Anfrage per POST an /v1/x/search und fragen Sie dann /v1/tasks/{task_id} ab, bis die Aufgabe abgeschlossen ist.
- Speichern Sie data.results.items und folgen Sie next_cursor, bis has_more den Wert false hat.
curl -X POST "https://api.socq.ai/v1/x/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"artificial intelligence","results_limit":40,"sort_by":"latest"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Twitter Search API
- Rund um einen benannten Produktstart zuhören: Suchen Sie nach einem Produkt, einer Veröffentlichung, einer Konferenz oder einer Kampagnenformulierung und ordnen Sie die passenden Posts nach Veröffentlichungs- und Erfassungszeit.
- Erwähnungen von Marken und Produkten verfolgen: Führen Sie Autoren, Text, sichtbare Interaktion, Hashtags, Erwähnungen und Medien für einen gezielten Namen oder Ausdruck zusammen.
- Ein sich entwickelndes Thema abbilden: Nutzen Sie latest-Ergebnisse, um neue Posts zu verfolgen, und top-Ergebnisse, um prominente Inhalte innerhalb desselben Rechercheausdrucks zu prüfen.
- Einen wiederkehrenden Abfrage-Datensatz pflegen: Speichern Sie extra.search_query bei jedem Treffer, führen Sie einen versionierten Ausdruck erneut aus und hängen Sie nur bisher unbekannte Post-IDs an.
Profi-Tipps zur Twitter Search API
- Beginnen Sie mit einem gezielten Ausdruck, prüfen Sie die Treffer und erweitern Sie die Formulierung nur, wenn die Abdeckung zu schmal ist.
- Wählen Sie latest für zeitkritisches Zuhören und top, wenn prominente Treffer wichtiger sind als die Chronologie.
- Setzen Sie results_limit als Vielfaches von 20 und verstehen Sie es als Obergrenze und nicht als garantierte Ergebniszahl.
- Versionieren Sie die Abfrage, sobald sich ihre Begriffe ändern, damit wiederkehrende Ergebnismengen vergleichbar bleiben.
- Deduplizieren Sie nach der Post-id und behalten Sie extra.search_query und collected_at als Kontext der Entdeckung bei.
Verwandte APIs
Ergänzend zur Twitter Search 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.
- X Post Replies API — Öffentliche Antworten aus X-Post-URLs erfassen – mit wählbarer Sortierung, Antworttext, Autoren, sichtbaren Interaktionen, Medien und Kontext des übergeordneten Posts.
- X Trends API — Aktuelle öffentliche X-Trend-Momentaufnahmen für bekannte numerische WOEIDs erfassen – mit Quellrang, Suchbegriff, Beschreibung und Ortskontext.
- 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.
- Twitter User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes 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