게시물 검색(최근)

​

최근 게시물 수 엔드포인트 시작하기

이 빠른 시작 가이드는 HTTP 요청을 전송할 수 있는 그래픽 도구인 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 컬렉션을 로드한 후, Post counts > Recent Post counts 요청으로 이동하세요.

2단계: 요청 인증하기

X API에 정상적으로 요청하려면 권한을 확인해야 합니다. 이 엔드포인트의 경우 OAuth 2.0 App-Only 방식으로 요청을 인증해야 합니다.

특히 App Access Token (App-only Bearer Token이라고도 함)을 포함해 Postman에 키와 토큰을 추가해야 합니다. Postman 우측 상단에서 “X API v2”라는 이름의 환경을 선택한 다음, 환경 드롭다운 옆의 눈 아이콘을 클릭해 “initial value” 및 “current value” 필드에 키와 토큰을 추가하세요.

올바르게 설정했다면 이 변수가 요청의 Authorization 탭에 자동으로 반영됩니다.  

3단계: 쿼리 만들기

각 최신 게시물 수 요청에는 단일 query가 필요합니다. 이 예시에서는 @XDevelopers 계정이 게시한 게시물과 일치하는 쿼리를 사용하겠습니다. 이 쿼리에서는 from: 연산자를 사용하고 값을 XDevelopers(대소문자 무시)로 설정합니다:

from:XDevelopers

Postman에서 “Params” 탭으로 이동하여 ids 매개변수의 “Value” 열에 이 ID 또는 쉼표로 구분된 게시물 ID 문자열을 입력하세요.

Key	Value	Description
query	from:XDevelopers	최신 게시물 수 엔드포인트에 제출할 쿼리

4단계(선택): 요청의 세분성 지정

3단계 후 ‘Send’ 버튼을 클릭하면 기본 최신 게시물 수(지난 7일 동안의 시간별)를 받게 됩니다. 일별 최신 게시물 수를 받으려면 값이 day인 granularity 매개변수를 추가하세요.

Postman에서 “Params” 탭으로 이동해 granularity 매개변수의 “Value” 열에 day를 입력하세요.

Key	Value	Description
granularity	day	게시물 수 결과의 세분성. 가능한 값은 day, hour, minute입니다

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

https://api.x.com/2/tweets/counts/recent?query=from%3AXDevelopers&granularity=day

5단계: 요청 보내고 응답 확인하기

모든 설정을 마쳤다면 “Send” 버튼을 클릭하여 다음과 같은 응답을 받습니다:

{
   "data": [
       {
           "end": "2021-06-16T00:00:00.000Z",
           "start": "2021-06-15T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-17T00:00:00.000Z",
           "start": "2021-06-16T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-18T00:00:00.000Z",
           "start": "2021-06-17T00:00:00.000Z",
           "tweet_count": 2
       },
       {
           "end": "2021-06-19T00:00:00.000Z",
           "start": "2021-06-18T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-20T00:00:00.000Z",
           "start": "2021-06-19T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-21T00:00:00.000Z",
           "start": "2021-06-20T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-22T00:00:00.000Z",
           "start": "2021-06-21T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-23T00:00:00.000Z",
           "start": "2021-06-22T00:00:00.000Z",
           "tweet_count": 2
       }
   ],
   "meta": {
       "total_tweet_count": 6
   }
}