Ereignistypen wählen

Standardmäßig erhalten Sie für jedes überwachte Konto jeden Ereignistyp. Das lässt sich pro Konto einschränken: Ein Konto schickt Ihnen nur seine neuen verifizierten Follower, ein anderes alles, was es veröffentlicht. Die Auswahl gehört zum Abonnement und wird deshalb für jedes Konto einzeln getroffen.

Was Sie wählen können

Jeder Ereignistyp unten lässt sich einzeln ein- oder ausschalten, für jedes Konto. Stichwort-Treffer (search.match) stehen nicht in der Liste: Sie stammen aus Stichwörtern, nicht aus Konten.

Typ	Kategorie	Bedeutung
`tweet.create`	Beiträge	Das Konto hat etwas Neues gepostet
`tweet.reply`	Beiträge	Es hat jemandem geantwortet; `reply_to` trägt den beantworteten Beitrag mit Text und Medien
`tweet.retweet`	Beiträge	Es hat jemanden repostet; `retweet_of` trägt den Originalbeitrag vollständig
`tweet.quote`	Beiträge	Es hat jemanden zitiert; `quoted` trägt den zitierten Beitrag vollständig
`tweet.edit`	Beiträge	Es hat einen Beitrag bearbeitet; das Ereignis trägt die neue Fassung, `edit_of` die Fassung, die sie ersetzt
`tweet.delete`	Beiträge	Ein Beitrag, den das Konto veröffentlicht hatte, ist verschwunden
`profile.name`	Profil	Anzeigename geändert
`profile.screen_name`	Profil	Handle geändert
`profile.bio`	Profil	Bio geändert
`profile.location`	Profil	Standort geändert
`profile.url`	Profil	Profil-Link geändert
`profile.avatar`	Profil	Avatar geändert; `old` und `new` sind Bild-URLs
`profile.banner`	Profil	Banner geändert; `old` und `new` sind Bild-URLs
`profile.pinned`	Profil	Angepinnter Beitrag geändert; `tweet` und `old_tweet` tragen die Beiträge selbst
`profile.verified`	Profil	Verifizierungsabzeichen erschienen oder verschwunden
`follow.add`	Folgt-Graph	Das Konto folgt jetzt jemandem; `user` ist das vollständige Profil dieses Kontos
`follow.remove`	Folgt-Graph	Das Konto folgt jemandem nicht mehr
`followers.verified.add`	Folgt-Graph	Ein verifiziertes Konto folgt ihm jetzt; `user` trägt Bio, Zähler, Standort, Beitrittsdatum
`account.status`	Konto	Das Konto wurde geschützt, gesperrt oder nicht mehr sichtbar, oder ist wieder aktiv

Häufige Auswahlen

Senden Sie den Wert aus der rechten Spalte als event_types. Typen lassen sich frei kombinieren; führen Sie so viele auf, wie Sie brauchen.

Sie wollen	`event_types`
Nur neue verifizierte Follower des Kontos	`["followers.verified.add"]`
Nur seine eigenen Beiträge	`["tweet.create"]`
Nur seine Antworten	`["tweet.reply"]`
Alles, was es veröffentlicht: Beiträge, Antworten, Reposts, Zitate und Bearbeitungen	`["tweet.create", … 5 Typen]`
Seine Beiträge und wenn es einen löscht	`["tweet.create", "tweet.delete"]`
Nur Profiländerungen (alle neun Profiltypen)	`["profile.name", … 9 Typen]`
Nur, wem es folgt und wem nicht mehr	`["follow.add", "follow.remove"]`
Alles (Standard)	`null`

So stellen Sie es ein

Wählen Sie beim Start der Überwachung oder ändern Sie es jederzeit danach. Beide Aufrufe brauchen den Scope targets:write.

Überwachung mit Auswahl starten

curl -X POST https://api.xsignalfeed.com/v1/monitor/targets \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"screen_name": "elonmusk", "event_types": ["followers.verified.add"]}'

Auswahl später ändern

curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": ["tweet.create", "tweet.reply"]}'

Zurück zu allen Typen

curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": null}'

Die aktuelle Auswahl des Kontos steht im Feld event_types; event_types_all ist true, wenn nichts ausgefiltert wird.

GET /v1/monitor/targets/elonmusk

{
  "target": {
    "id": "44196397",
    "screen_name": "elonmusk",
    "name": "Elon Musk",
    "state": "subscribed",
    "…": "…",
    "event_types": [
      "tweet.create",
      "tweet.reply"
    ],
    "event_types_all": false
  }
}

Regeln

Wer event_types beim Start der Überwachung weglässt, erhält alle Typen.
event_types ersetzt die gesamte Auswahl; es wird nichts hinzugefügt. Wird der Überwachungsaufruf ohne event_types wiederholt, bleibt die aktuelle Auswahl bestehen.
null oder [] bedeutet alle Typen. Werden alle Typen der Liste gewählt, wird das genauso gespeichert.
Die Auswahl gilt gleichermaßen für Stream, Webhooks und GET /v1/events. Eine offene Verbindung übernimmt eine Änderung bei ihrer nächsten Aktualisierung, nicht sofort.
Ein update, das den Typ eines Beitrags ändert (es trägt kind_was), erreicht Sie, wenn einer der beiden Typen in Ihrer Auswahl ist. Nehmen Sie tweet.create, aber nicht tweet.quote, erhalten Sie trotzdem das update, das zeigt, dass ein Beitrag ein Zitat war, und können ihn verwerfen; nehmen Sie tweet.quote, aber nicht tweet.create, erreicht Sie ein solches Zitat zuerst als dieses update.
Erweitern Sie die Auswahl, kommen die hinzugefügten Typen ab diesem Moment an. Ereignisse dieser Typen aus der Zeit vor der Änderung sind über GET /v1/events nicht garantiert verfügbar.
Ein Schlüssel kann zusätzlich eine schlüsselweite Liste haben, die wir auf Ihren Wunsch setzen (event_types in GET /v1/account). Ein Ereignis erreicht Sie nur, wenn beide Listen es erlauben.
Ein unbekannter Typ wird mit 400 invalid_request abgelehnt; details.unknown nennt ihn, details.allowed listet die verwendbaren. GET /v1/meta/event-types liefert die vollständige Liste.
Stichwörter werden pro Stichwort gewählt, nicht hier: Beobachten Sie ein Stichwort oder hören Sie damit auf, um seine search.match-Ereignisse zu erhalten oder nicht mehr zu erhalten.

Was sich nicht wählen lässt

Neue, nicht verifizierte Follower werden nicht als Ereignis angeboten und lassen sich daher nicht wählen. Angeboten werden nur neue verifizierte Follower (followers.verified.add).
Gewählt wird nur nach Ereignistyp, nicht nach Inhalt. Bedingungen wie „verifizierte Follower mit mehr als 10.000 Followern“, „nur Beiträge mit Bildern“ oder „nur auf Englisch“ wenden Sie selbst an, anhand der Felder im Payload (zum Beispiel user.followers, media, lang).