はじめに

アカウントのセットアップ

これらのエンドポイントにアクセスするには、以下が必要です。

• 承認済みの開発者アカウント
• Project 内にある開発者アプリのキーとトークンを使用して認証すること

X API v2 のエンドポイントへのアクセス方法については、はじめにガイドをご覧ください。

はじめに

​

認証

このエンドポイントは、OAuth 1.0a ユーザーコンテキスト、OAuth 2.0 App-Only、または OAuth 2.0 認可コード（PKCE 対応） のいずれかで認証できます。  

​

リクエストの送信

以下のように ID を指定して Communities Lookup エンドポイントを呼び出せます（使用する ID は 1758747817642700922）:

      curl --location 'https://api.x.com/2/communities/1758747817642700922' --header 'Authorization: ••••••'

リクエストが成功すると、以下のような JSON レスポンスが表示されます。

{
    "data": {
        "access": "Public",
        "description": "アニメコミュニティへようこそ！アニメファンが集まり、お気に入りの作品を共有したり、アニメに関するあらゆることを語り合ったりする場所です。",
        "join_policy": "Open",
        "name": "Anime Community"
    }
}

​

コミュニティ fields

Community Fields を指定すると、コミュニティに関連付けられた追加データを取得できます。

利用可能な Community Fields は次のとおりです:

フィールド値	型	説明
created_at	date (ISO 8601)	コミュニティの作成日時。
id	string	コミュニティの一意の識別子。
name	string	コミュニティ名。
description	string	（指定されている場合の）コミュニティの説明テキスト。
access	string	コミュニティのアクセスレベル。 次のいずれか: * Public * Closed
join_policy	string	コミュニティの参加ポリシー。 次のいずれか: * Open * RestrictedJoinRequestsDisabled * RestrictedJoinRequestsRequireAdminApproval * RestrictedJoinRequestsRequireModeratorApproval * SuperFollowRequired
member_count	integer	コミュニティに参加しているメンバー数。

​

リクエスト例

以下のように、追加のコミュニティ fields を指定して Communities Lookup エンドポイントを呼び出せます（ID 1758747817642700922 を使用）:

curl --location 'https://api.x.com/2/communities/1758747817642700922?community.fields=access,created_at,description,id,join_policy,member_count,name' --header 'Authorization: ••••••'

レスポンス例

リクエストが成功すると、次のような JSON レスポンスが表示されます。

{
    "data": {
        "description": "アニメコミュニティへようこそ！アニメファンが集まり、お気に入りの作品を共有し、アニメに関するあらゆることを語り合う場所です。",
        "access": "Public",
        "member_count": 40369,
        "created_at": "2024-02-17T06:58:50.000Z",
        "join_policy": "Open",
        "name": "アニメコミュニティ",
        "id": "Q29tbXVuaXR5OjE3NTg3NDc4MTc2NDI3MDA5MjI="
    }
}