메인 콘텐츠로 건너뛰기

​
목록 게시물 조회 엔드포인트 시작하기

이 빠른 시작 가이드는 Postman을 사용해 목록 게시물 조회 엔드포인트에 첫 요청을 보내는 방법을 안내합니다. 여러 언어의 샘플 코드를 확인하려면 X API v2 샘플 코드 GitHub 리포지토리를 방문하세요.

​
필수 준비 사항

이 가이드를 완료하려면 요청 인증에 필요한 키와 토큰 세트가 있어야 합니다. 다음 단계를 따라 키와 토큰을 생성할 수 있습니다.
  • 개발자 계정에 가입해 승인을 받습니다.
  • 개발자 포털에서 Project와 연결된 Developer 앱을 생성합니다.
  • 앱의 “Keys and tokens” 페이지로 이동해 필요한 자격 증명을 생성합니다. 모든 자격 증명은 안전한 위치에 보관하세요.

​
목록 게시물 조회 요청을 생성하는 단계

​
1단계: 도구 또는 라이브러리로 시작하기

이 엔드포인트에 요청을 보내는 데 사용할 수 있는 도구, 코드 예제, 라이브러리가 여러 가지 있지만, 여기서는 과정을 단순화하기 위해 Postman을 사용하겠습니다. X API v2 Postman 컬렉션을 환경에 로드하려면 다음 버튼을 클릭하세요:
Postman에서 X API v2 컬렉션을 로드한 후 “List” 폴더로 이동하고 “List Posts” 폴더를 선택한 다음 “List Posts lookup”을 선택하세요.  

​
2단계: 요청 인증

X API에 올바르게 요청하려면 권한이 있는지 확인해야 합니다. 이 엔드포인트에서는 앱 전용, OAuth 2.0 Authorization Code with PKCE, 또는 OAuth 1.0a 사용자 컨텍스트 인증 방식을 사용해 요청을 인증해야 합니다. 간단히 하기 위해 이번 요청에는 앱 전용을 사용하겠지만, 비공개 메트릭 또는 게시물을 요청하려면 다른 인증 방식 중 하나를 사용해야 합니다. 앱 전용을 사용하려면 Postman에서 우측 상단의 “X API v2” 환경을 선택한 다음, 키와 토큰(특히 앱 전용 액세스 토큰, 즉 앱 전용 베어러 토큰)을 “initial value” 및 “current value” 필드에 추가하세요(환경 드롭다운 옆의 눈 모양 아이콘 클릭). 올바르게 설정했다면 이러한 변수는 요청의 Authorization 탭에 자동으로 채워집니다.  

​
3단계: 어떤 리스트에서 게시물을 가져올지 확인하고 지정하기

요청에서 수신하려는 리스트를 반드시 지정해야 합니다. x.com에서 해당 리스트를 클릭한 뒤, URL에서 리스트 ID를 확인할 수 있습니다. 예를 들어, 아래 URL의 리스트 ID는 84839422입니다. https://x.com/i/lists/84839422 대상 ID는 유효한 리스트 ID라면 무엇이든 사용할 수 있습니다. Postman에서 “Params” 탭으로 이동해 id 경로 변수의 “Value” 열에 ID를 입력하세요. ID 앞이나 뒤에 공백이 포함되지 않도록 주의하세요.
KeyValue
id84839422 (리스트 ID)

​
4단계: 가져올 필드를 파악하고 지정하기

3단계를 마친 뒤 “Send” 버튼을 클릭하면 응답에 기본 게시물 객체 필드인 id와 text가 반환됩니다. 추가 필드를 받으려면 요청에서 tweet.fields 및/또는 expansions 매개변수로 해당 필드를 지정해야 합니다. 이 연습에서는 서로 다른 객체에서 세 가지 추가 필드 세트를 요청합니다.
  • 기본 Lists 객체의 추가 created_at 필드
  • expansions 매개변수를 사용한 전체 user 객체
  • 연관된 user 객체의 추가 user.created_at 필드
Postman에서 “Params” 탭으로 이동해 “Query Params” 표에 다음 키:값 쌍을 추가하세요.
KeyValueReturned fields
tweet.fieldscreated_atcreated_at
expansionsauthor_idincludes.users.id,
includes.users.name,
includes.users.username
user.fieldscreated_atincludes.users.created_at
이제 “Send” 버튼 옆에 다음과 유사한 URL이 표시됩니다: https://api.x.com/2/lists/84839422/tweets?expansions=author_id&user.fields=created_at&max_results=1

​
5단계: 요청 보내기 및 응답 검토

모든 설정을 마쳤다면 “Send” 버튼을 클릭하세요. 그러면 아래 예시와 유사한 응답을 받게 됩니다: 
{
  "data": [
    {
      "author_id": "4172587277",
      "id": "1458172421115101189",
      "text": "독일은 이번 주 코로나19 신규 확진자 기록을 경신했습니다. 정부와 보건 전문가들에 따르면, 백신 미접종자들이 이러한 상황의 원인으로 지목되고 있습니다 \nhttps://t.co/4POyaPwMLu"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "MomentsBrasil",
        "name": "X Moments 브라질",
        "created_at": "2015-11-12T16:46:02.000Z",
        "id": "4172587277"
      }
    ]
  },
  "meta": {
    "result_count": 1,
    "next_token": "7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix"
  }
}
참고: 이 엔드포인트의 응답은 지정된 리스트에 대해 최신 게시물 최대 800개까지 조회를 지원합니다