API-Referenz · v1
Alles, was ein X-Konto tut, über eine Verbindung
xSignalFeed beobachtet die von Ihnen benannten X-Konten (ehemals Twitter) und sendet Ihnen, was sie tun, während es geschieht: neue Beiträge, Antworten, Reposts, Zitate, Löschungen, Profiländerungen, neue Folgt-Beziehungen und neue verifizierte Follower. Sie können auch die X-Suche nach einer Phrase beobachten und Profile, Beiträge, Follower, Listen, Communities und Trends auf Abruf lesen. Ein WebSocket trägt die Ereignisse; REST ist für die Momente da, in denen Sie fragen müssen, statt zu warten.
Einführung
Es gibt drei Arten, den Dienst zu nutzen. Überwachung: Benennen Sie Konten und Stichwörter und empfangen Sie Ereignisse über einen WebSocket oder einen Webhook, während sie geschehen. Historie: Lesen Sie die Ereignisse nach, die Ihr Schlüssel empfangen hat. Lesezugriffe: Fragen Sie X jetzt nach einem Profil, einem Beitrag, einer Suche, einer Liste, einer Community oder den Trends.
Ereignisse gibt es in vier Familien. Jede hat genau eine Nutzlastform, die unter Ereignisse Feld für Feld beschrieben ist.
| Kategorie | Typen | Bedeutung |
|---|---|---|
| Beiträge | tweet.create, tweet.reply, tweet.retweet, tweet.quote, tweet.edit, tweet.delete | Was das Konto veröffentlicht: neue Beiträge, Antworten, Reposts, Zitate, Bearbeitungen sowie Löschungen von jedem davon |
| Profil | profile.name, profile.screen_name, profile.bio, profile.location, profile.url, profile.avatar, profile.banner, profile.pinned, profile.verified | Jede Änderung dessen, was das Konto über sich zeigt, mit dem alten und dem neuen Wert |
| Folgt-Graph | follow.add, follow.remove, followers.verified.add | Wem das Konto zu folgen beginnt oder aufhört, und welche verifizierten Konten ihm zu folgen beginnen |
| Konto | account.status | Ob das Konto überhaupt sichtbar ist: geschützt, gesperrt, nicht sichtbar oder wieder aktiv |
| Suche | search.match | Beiträge von jedem auf X, die zu einem von Ihnen beobachteten Stichwort passen |
Der Zugang erfolgt per API-Schlüssel. Ein Schlüssel trägt Berechtigungen und Obergrenzen, die aus seinem Tarif stammen; GET /v1/account sagt Ihnen, was Ihrer darf. Nichts hier wird nach dem Ereignisvolumen abgerechnet: Streaming ist inbegriffen, und nur Lesezugriffe auf Abruf verbrauchen Guthaben.
xSignalFeed ist ein unabhängiger Drittanbieterdienst. Er ist weder mit X Corp verbunden noch von X Corp unterstützt oder gesponsert. Wir lesen ausschließlich öffentliche Daten.
Wie weiter
Schnellstart
Prüfen Sie Ihren Schlüssel, überwachen Sie ein Konto und lesen Sie Ihr erstes Ereignis – in vier Schritten.
Grundkonzepte
Ziele und Stichwörter, Zustellung in zwei Frames, mindestens einmal, Wiedergabe.
Ereignisse
Der Umschlag, jeder Ereignistyp und die fünf Nutzlastformen Feld für Feld.
API-Referenz
Eine Seite pro Endpunkt: Parameter, Antwort sowie ein Beispiel für Anfrage und Antwort.