イベント種類の選択

既定では、監視している各アカウントのすべてのイベント種類が届きます。これはアカウントごとに絞り込めます。あるアカウントからは新しい認証済みフォロワーだけ、別のアカウントからは投稿のすべて、というように。選択は購読に属するので、アカウントごとに別々に決まります。

選べるもの

以下のイベント種類は、アカウントごとに一つずつオン・オフできます。キーワード一致（search.match）はこの一覧に含まれません。これはアカウントではなくキーワードから届くものです。

型カテゴリー意味
tweet.create投稿アカウントが新しく投稿した
tweet.reply投稿誰かに返信した。reply_to に返信先の投稿がテキストとメディア付きで入ります
tweet.retweet投稿誰かの投稿をリポストした。retweet_of に元投稿の全体が入ります
tweet.quote投稿誰かの投稿を引用した。quoted に引用元投稿の全体が入ります
tweet.edit投稿投稿を編集しました。イベントは新しい版を運び、edit_of は置き換えられた版です
tweet.delete投稿アカウントが公開していた投稿が消えた
profile.nameプロフィール表示名が変わった
profile.screen_nameプロフィールハンドルが変わった
profile.bioプロフィール自己紹介が変わった
profile.locationプロフィール場所が変わった
profile.urlプロフィールプロフィールリンクが変わった
profile.avatarプロフィールアバターが変わった。old と new は画像 URL
profile.bannerプロフィールバナーが変わった。old と new は画像 URL
profile.pinnedプロフィール固定投稿が変わった。tweet と old_tweet に投稿そのものが入ります
profile.verifiedプロフィール認証バッジが付いた、または外れた
follow.addフォローグラフアカウントが誰かをフォローし始めた。user はその相手の完全なプロフィール
follow.removeフォローグラフアカウントが誰かのフォローをやめた
followers.verified.addフォローグラフ認証済みアカウントがフォローし始めた。user に自己紹介、各種カウント、場所、登録日が入ります
account.statusアカウントアカウントが非公開、凍結、閲覧不可になった、または通常に戻った

よくある選び方

右の列の値を event_types として送ってください。種類は自由に組み合わせられ、必要なだけ並べられます。

欲しいものevent_types
そのアカウントの新しい認証済みフォロワーだけ["followers.verified.add"]
オリジナル投稿だけ["tweet.create"]
返信だけ["tweet.reply"]
発信するものすべて：投稿、返信、リポスト、引用、編集["tweet.create", … 5 種類]
投稿と、その削除["tweet.create", "tweet.delete"]
プロフィールの変更だけ（プロフィール系 9 種類すべて）["profile.name", … 9 種類]
誰をフォロー・フォロー解除したかだけ["follow.add", "follow.remove"]
すべて（既定）null

設定方法

監視を始めるときに選ぶことも、後からいつでも変えることもできます。どちらの呼び出しにも targets:write スコープが必要です。

選択を指定して監視を始める
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"]}'
後から選択を変える
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"]}'
すべての種類に戻す
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}'

アカウントの現在の選択は event_types フィールドにあり、何も除外していなければ event_types_all が true です。

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
  }
}

ルール

選べないもの