메인 콘텐츠로 건너뛰기
리스트 조회 엔드포인트를 사용하면 리스트 정보를 가져올 수 있습니다. ID로 특정 리스트를 조회하거나, 사용자가 소유한 모든 리스트를 가져올 수 있습니다.

개요

ID로

특정 리스트의 세부 정보를 조회합니다

소유자별

사용자가 소유한 모든 리스트를 조회합니다

엔드포인트

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

응답 필드

응답에는 기본적으로 idname이 포함됩니다. 다음과 같은 추가 필드를 요청할 수 있습니다:
FieldDescription
description리스트 설명
owner_id소유자의 사용자 ID
private리스트가 비공개인지 여부
follower_count팔로워 수
member_count멤버 수
created_at리스트 생성 일시

요청 예시

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

시작하기

사전 준비 사항

빠른 시작

첫 리스트 조회 요청 보내기

통합 가이드

핵심 개념과 모범 사례

API 참조 문서

엔드포인트 전체 문서

샘플 코드

동작하는 코드 예제