Search Tweets
Search tweets using Twitter/X advanced search syntax. Supports Latest and Top result types. Returns tweet data including text, author, engagement metrics, and media. Paginated with cursor. Ideal for: monitoring keywords, tracking conversations, content discovery, sentiment analysis.
Katalogaktion Sozial
Suchen von Tweets mit der erweiterten Suchsyntax von Twitter/X. Unterstützt die Ergebnistypen Latest und Top. Gibt Tweet-Daten zurück, einschließlich Text, Autor, Engagement-Metriken und Medien. Paginiert mit Cursor. Ideal für: Überwachung von Schlüsselwörtern, Verfolgung von Gesprächen, Inhaltsentdeckung, Stimmungsanalyse.
Auf einen Blick
| Feld | Wert |
|---|---|
| Action-ID | x-search-tweets |
| Kategorie | Social |
| Connector | Nicht erforderlich |
| Erfordert Gas | Nein |
| Mittelbewegungen | Keine deklariert |
| Tags | social, twitter, x, tweets, search, read |
Payload-Schema
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
query | string | Ja | Suchabfrage mit erweiterter Twitter-Suchsyntax (z. B. 'from:elonmusk', '#crypto', 'bitcoin OR ethereum') |
queryType | string | Nein | Ergebnistyp: 'Latest' für chronologische Reihenfolge, 'Top' für am meisten engagierte Tweets. Standard: 'Latest' |
cursor | string | null | Nein | Paginationscursor aus einer vorherigen Antwort, um die nächste Seite der Ergebnisse abzurufen. 'null' wird wie das Weglassen des Feldes behandelt – nützlich für Round-Tripping von 'nextCursor' aus einer vorherigen Antwort ohne zusätzliche bedingte Logik. |
Ergebnisschema
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
status | string | Ja | 'success' oder 'error' |
tweets | array | Ja | Array von Tweet-Objekten, die zur Suchabfrage passen |
totalResults | number | Ja | Anzahl der in dieser Antwort zurückgegebenen Tweets |
hasNextPage | boolean | Ja | Ob weitere Ergebnisse über Pagination verfügbar sind |
nextCursor | string | null | Nein | Cursor für die nächste Anfrage zur folgenden Seite oder null, wenn keine weiteren Ergebnisse |
error | string | Nein | Fehlermeldung, wenn status 'error' ist |
Beispiele
json{ "type": "x-search-tweets", "payload": { "query": "status:open" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/x-search-tweets/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "query": "status:open" }}'
Payload-Felder können Workflow-Ausdrücke wie {{$trigger.body.amount}}, {{$nodes.fetch.result.price}} und {{$props.asset}} verwenden, wenn der Wert aus einem Trigger, einem vorherigen Knoten oder einer wiederverwendbaren Workflow-Eigenschaft stammen soll.