메인 콘텐츠로 건너뛰기
이 가이드는 애플리케이션에 리스트 조회 엔드포인트를 통합하는 데 알아두어야 할 핵심 개념을 다룹니다.

​
인증

리스트 조회 엔드포인트는 여러 인증 방식을 지원합니다:
방식적합한 용도비공개 리스트 접근 가능 여부
OAuth 2.0 App-Only공개 리스트 데이터아니요
OAuth 2.0 Authorization Code with PKCE사용자 대상 App예 (소유/팔로우)
OAuth 1.0a User Context레거시 통합예 (소유/팔로우)

​
요청 예시

cURL
curl "https://api.x.com/2/lists/84839422?\
list.fields=description,member_count,follower_count,private" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
엔드포인트 개요

MethodEndpointDescription
GET/2/lists/:idID로 리스트 조회
GET/2/users/:id/owned_lists사용자가 소유한 리스트 조회

​
필드 및 expansions

​
기본 응답

{
  "data": {
    "id": "84839422",
    "name": "Tech News"
  }
}

​
사용 가능한 필드

필드설명
created_at리스트가 생성된 타임스탬프
description리스트 설명
follower_count팔로워 수
member_count멤버 수
owner_id소유자의 사용자 id
private리스트가 비공개인지 여부
필드설명
username소유자의 @핸들
name소유자의 표시 이름
verified소유자의 인증 상태
profile_image_url소유자의 아바타 URL

​
expansions를 사용한 예시

cURL
curl "https://api.x.com/2/lists/84839422?\
list.fields=description,member_count,follower_count,owner_id&\
expansions=owner_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
확장(expansions)을 포함한 응답

{
  "data": {
    "id": "84839422",
    "name": "Tech News",
    "description": "Top tech journalists",
    "member_count": 50,
    "follower_count": 1250,
    "owner_id": "2244994945"
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

필드 및 expansions 가이드

응답을 커스터마이징하는 방법을 자세히 알아보세요
소유한 리스트를 조회하면, 결과가 여러 페이지로 나뉘어 반환됩니다:
cURL
# 첫 번째 요청
curl "https://api.x.com/2/users/123/owned_lists?max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

# 페이지네이션 토큰을 사용한 다음 요청
curl "https://api.x.com/2/users/123/owned_lists?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $BEARER_TOKEN"

페이지네이션 가이드

페이지네이션에 대해 자세히 알아보기

​
비공개 리스트

  • 비공개 리스트는 소유자만 볼 수 있습니다.
  • 비공개 리스트의 상세 정보를 조회하려면 리스트 소유자 계정으로 인증해야 합니다.
  • private 필드는 리스트가 비공개인지 여부를 나타냅니다.

​
오류 처리

Status오류해결 방법
400잘못된 요청리스트 ID 형식을 확인하세요
401인증 실패인증 정보를 확인하세요
403접근이 거부됨리스트가 비공개일 수 있습니다
404찾을 수 없음리스트가 존재하지 않습니다
429요청이 너무 많음잠시 기다렸다가 다시 시도하세요

​
다음 단계

빠른 시작

첫 번째 리스트 조회 요청을 보내세요

리스트 포스트

리스트에서 포스트를 가져오기

API 참조 문서

엔드포인트 전체 문서

샘플 코드

실행 가능한 코드 예제