리트윗 조회

​

리트윗 조회 엔드포인트 시작하기

이 빠른 시작 가이드는 Postman을 사용해 리트윗 조회 엔드포인트로 첫 요청을 보내는 방법을 안내합니다. 다양한 언어의 샘플 코드를 보고 싶다면 X API v2 샘플 코드 GitHub 리포지토리를 방문하세요.

​

사전 준비 사항

이 가이드를 완료하려면 요청을 인증할 키와 토큰이 필요합니다. 다음 단계를 따라 키와 토큰을 생성하세요.

• 개발자 계정에 등록하고 승인을 받습니다.
• 개발자 포털에서 Project와 연결된 Developer 앱을 생성합니다.
• App의 “Keys and tokens” 페이지로 이동해 필요한 자격 증명을 생성합니다. 모든 자격 증명은 안전한 위치에 보관하세요.

​

리트윗 조회 요청을 빌드하는 단계

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

이 엔드포인트에 요청을 보내는 방법은 여러 도구, 코드 예제, 라이브러리가 있지만, 여기서는 절차를 간소화하기 위해 Postman을 사용하겠습니다.

환경에 X API v2 Postman 컬렉션을 로드하려면 다음 버튼을 클릭하세요:

Postman에 X API v2 추가하기

Postman에서 X API v2 컬렉션을 불러온 후, “Retweets” 폴더로 이동해 “Retweeted by”를 선택하세요.

2단계: 요청 인증

X API에 요청하려면 먼저 권한이 있는지 확인해야 합니다. 이를 위해 이 엔드포인트는 요청을 OAuth 2.0 App-Only, OAuth 2.0 Authorization Code with PKCE, 또는 OAuth 1.0a 사용자 컨텍스트 인증 방식 중 하나로 인증할 것을 요구합니다.

단순화를 위해 이 요청에는 OAuth 2.0 App-Only를 사용하지만, 비공개 지표 또는 리트윗을 요청하려면 다른 인증 방법 중 하나를 사용해야 합니다.

OAuth 2.0 App-Only를 사용하려면 Postman에 키와 토큰, 특히 App Access Token (App-only Bearer Token이라고도 함)을 추가해야 합니다. Postman 오른쪽 상단에서 “X API v2”라는 이름의 환경을 선택하고, 환경 드롭다운 옆 눈 아이콘을 클릭해 “initial value” 및 “current value” 필드에 키와 토큰을 입력하면 됩니다.

올바르게 설정했다면 이 변수들이 요청의 인증 탭에 자동으로 채워집니다.

3단계: 게시물 지정

이 엔드포인트를 사용할 때는 리트윗한 사용자를 조회할 게시물의 ID를 지정해야 합니다. X에서 해당 게시물로 이동한 다음 URL 끝의 숫자 값을 가져오면 게시물 ID를 확인할 수 있습니다. 예를 들어, 다음 URL의 게시물 ID는 1354143047324299264입니다.

https://x.com/TwitterDev/status/1354143047324299264

Postman에서 “Params” 탭으로 이동한 다음, 섹션 하단에 있는 id 경로 변수의 “Value” 열에 이 사용자 이름을 입력하세요. 사용자 이름 앞뒤에 공백이 포함되지 않도록 하세요.

키	값
id	리트윗한 사용자 목록을 조회하려는 게시물의 id

4단계: 가져올 필드를 확인하고 지정합니다

3단계 이후 “Send” 버튼을 클릭하면 응답에 기본 user object 필드인 id, name, username이 포함됩니다.

id, name, username 외에 추가 필드를 받으려면, 요청에서 fields 및/또는 expansions 매개변수를 사용해 해당 필드를 지정해야 합니다.

이번 연습에서는 서로 다른 객체에서 추가 필드 세 가지 세트를 요청하겠습니다:

1. 기본 사용자 객체에 추가된 user.created_at 필드.
2. 반환된 사용자에 대해 연결된 고정 게시물 객체의 기본 필드는 id와 text입니다.
3. 연관된 게시물 객체에 있는 추가 tweet.created_at 필드.

Postman에서 “Params” 탭으로 이동한 뒤 “Query Params” 테이블에 다음 키:값 쌍을 추가하세요:

키	값	반환 필드
user.fields	created_at	user.created_at
expansions	pinned_tweet_id	tweet.id, tweet.text
tweet.fields	created_at	tweet.created_at

이제 “Send” 버튼 옆에 다음 URL이 표시됩니다:

https://api.x.com/2/tweets/1354143047324299264/retweeted_by?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at

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

모든 설정을 마쳤다면 “Send” 버튼을 클릭하세요. 그러면 아래 예시와 유사한 응답을 받게 됩니다:

{
  "data": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Twitter 고객지원"
    },
    {
      "created_at": "2007-02-20T14:35:54.000Z",
      "id": "783214",
      "username": "Twitter",
      "name": "Twitter"
    },
    {
      "pinned_tweet_id": "1389270063807598594",
      "created_at": "2018-11-21T14:24:58.000Z",
      "id": "1065249714214457345",
      "username": "TwitterSpaces",
      "name": "Spaces"
    },
    {
      "pinned_tweet_id": "1293595870563381249",
      "created_at": "2007-05-23T06:01:13.000Z",
      "id": "6253282",
      "username": "XAPI",
      "name": "X API"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-05-03T17:26:09.000Z",
        "id": "1389270063807598594",
        "text": "이제 팔로워가 600명 이상인 모든 사용자가 Space를 주최할 수 있습니다.\n\n우리가 배운 바에 따르면, 이러한 계정은 기존 청중 덕분에 주최 경험이 좋을 가능성이 높습니다. 모든 사용자에게 Space 생성 기능을 제공하기 전에, 우리는 몇 가지에 집중하고 있습니다. 🧵"
      },
      {
        "created_at": "2020-08-12T17:11:04.000Z",
        "id": "1293595870563381249",
        "text": "X API v2: 얼리 액세스 출시\n\n오늘 우리는 새로운 Twitter API의 첫 번째 엔드포인트에 대한 얼리 액세스를 발표했습니다!\n\n#TwitterAPI #EarlyAccess #VersionBump https://t.co/g7v3aeIbtQ"
      }
    ]
  }
}