Threads API

メンション

Threadsプロフィールが別のThreadsプロフィールにタグ付けされた公開Threadsメディアオブジェクトの一覧を返します。

アクセス許可

ThreadsメンションAPIには、対象としているノードに応じて、適切なアクセストークンとアクセス許可が必要です。テスト中に、グラフAPIエクスプローラを使って、簡単にトークンを生成し、アプリにアクセス許可を付与できます。

  • threads_basic — すべてのThreads APIエンドポイントに何らかの呼び出しを実行する場合に必要です。
  • threads_manage_mentions — メンションのエンドポイントへの呼び出しには必須です。

あなたのアプリがthreads\_manage\_mentionsアクセス許可のAdvanced Access承認を得ていない場合、取得できるメンションはアプリ上でThreadsテスターが行ったものだけです。承認後、ほかユーザーの公開投稿も返されます。

制限

  • 非公開ユーザーが作成したThreadsメディアオブジェクトは返されません。
  • sinceパラメーターのタイムスタンプは1688540400以上で、untilパラメーターより小さくなければなりません。現在のタイムスタンプ以下で、かつsinceより大きい必要があります。

Threadsのメンションを取得する

フィールド

fieldsパラメーターを使って、返されるThreadsメディアオブジェクトに含めたいフィールドを指定します。

リクエストの例

curl -s -X GET \
  https://graph.threads.net/<THREADS_USER_ID>/mentions?fields=<LIST_OF_FIELDS>&access_token=<ACCESS_TOKEN>

応答の例

APIコールが成功すると、Threadsメディアオブジェクトを含むJSON形式のオブジェクトが返されます。

{
  "<FIELD>":"<VALUE>",
  ...
}