x/
search

Öffentliche X-Posts mit einem gezielten Ausdruck durchsuchen, die Sortierung nach latest oder top wählen und passende Inhalte, Autoren, Interaktion, Medien, Entitäten und den Kontext der Ursprungsabfrage erhalten.

Twitter Search API

Entdeckung per Abfrage
Latest oder Top
Nachweis der Ursprungsabfrage
0,7 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
queryErforderlichErforderliches, nicht leeres Stichwort oder erforderlicher Suchausdruck für X-Posts, mit dem passende öffentliche Posts gefunden werden.
results_limitOptionalOptionale Obergrenze für die angeforderten Ergebnisse. Standard ist 20; zulässig sind Vielfache von 20 von 20 bis 2.000.
sort_byOptionalOptionale 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.

  1. Schreiben Sie einen gezielten, nicht leeren Ausdruck für die X-Posts, die Sie finden möchten.
  2. Wählen Sie latest oder top und legen Sie ein results_limit von 20 bis 2.000 in Schritten von 20 fest.
  3. Senden Sie die Anfrage per POST an /v1/x/search und fragen Sie dann /v1/tasks/{task_id} ab, bis die Aufgabe abgeschlossen ist.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

Twitter Search API — FAQ

Twitter Search API findet öffentliche X-Posts zu einem Suchausdruck. Sie liefert strukturierte Postinhalte, Autoren, Interaktion, Medien, Entitäten, Beziehungen und die Ursprungsabfrage.

Verwenden Sie ein nicht leeres Stichwort oder einen Suchausdruck, der die Marke, das Produkt, die Veranstaltung, die Formulierung oder das Thema beschreibt, das Sie untersuchen möchten.

Wählen Sie latest, um aktuelle Treffer zu bevorzugen, und top, um prominente Treffer zu prüfen. Standard ist latest.

results_limit ist standardmäßig 20 und akzeptiert Vielfache von 20 von 20 bis 2.000. Es legt die maximal angeforderte Zahl der Ergebnisse fest.

Ein Ergebnis kann Text, Sprache, Autorendaten, sichtbare Interaktion, Medien, Hashtags, Erwähnungen, Zeitstempel und Gesprächsbeziehungen enthalten.

Ja. extra.search_query trägt den übergebenen Ausdruck, sodass der Treffer mit seiner Entdeckungsregel verbunden bleiben kann.

Das Limit ist eine Obergrenze der Erfassung, während die tatsächliche Zahl die berechtigten öffentlichen Treffer widerspiegelt, die zum Zeitpunkt der Aufgabe verfügbar sind.

Jedes zurückgegebene normalisierte Suchergebnis kostet 0,7 SocQ-Credits.