소개

계정 설정

이러한 엔드포인트에 액세스하려면 다음이 필요합니다.

• 승인된 개발자 계정
• Project 내 Developer 앱의 키와 토큰을 사용한 인증

X API v2 엔드포인트 액세스 방법은 시작 가이드에서 자세히 알아보세요.

시작하기

​

인증

이 엔드포인트는 OAuth 1.0a 사용자 컨텍스트, OAuth 2.0 App-Only, 또는 OAuth 2.0 Authorization Code with PKCE 중 하나를 사용하여 인증할 수 있습니다.  

​

요청 보내기

아래와 같이 id를 제공하여 Communities Lookup 엔드포인트를 호출할 수 있습니다(예: id 1758747817642700922).

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

요청이 성공하면 아래와 같은 JSON 응답이 표시됩니다:

{
    "data": {
        "access": "공개",
        "description": "애니 커뮤니티에 오신 것을 환영합니다! 애니 팬들이 모여 좋아하는 작품을 공유하고 애니와 관련된 모든 주제를 논의하는 공간입니다.",
        "join_policy": "자유 가입",
        "name": "애니 커뮤니티"
    }
}

​

커뮤니티 필드

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	커뮤니티에 가입한 구성원 수.

​

예시 요청

아래와 같이 추가 커뮤니티 필드를 포함해 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": "Anime 커뮤니티에 오신 것을 환영합니다! 애니 팬들이 모여 좋아하는 작품을 공유하고 애니메이션과 관련된 모든 주제를 함께 이야기하는 공간입니다.",
        "access": "공개",
        "member_count": 40369,
        "created_at": "2024-02-17T06:58:50.000Z",
        "join_policy": "자유 가입",
        "name": "Anime 커뮤니티"
        "id": "Q29tbXVuaXR5OjE3NTg3NDc4MTc2NDI3MDA5MjI="
    }
}