메인 콘텐츠로 건너뛰기

​
최근 검색 엔드포인트 시작하기

이 빠른 시작 가이드는 Postman을 사용해 지정한 필드와 함께 최근 검색 엔드포인트에 첫 요청을 보내는 방법을 안내합니다. 다양한 언어의 샘플 코드를 확인하려면 X API v2 샘플 코드 GitHub 저장소를 방문하세요.

​
사전 준비 사항

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

​
최근 검색 요청 빌드 단계

1단계: 도구 또는 라이브러리로 시작하기 이 엔드포인트에 요청을 보내는 데 사용할 수 있는 다양한 도구, 코드 예제, 라이브러리가 있지만, 여기서는 과정을 단순화하기 위해 Postman을 사용하겠습니다. X API v2 Postman 컬렉션을 환경에 로드하려면 다음 버튼을 클릭하세요:
Postman에 X API v2 컬렉션을 로드한 후, Search Posts > Recent search 요청으로 이동하세요. 2단계: 요청 인증 X API에 정상적으로 요청하려면 권한 보유 여부를 확인해야 합니다. 이를 위해 이 엔드포인트에서는 OAuth 2.0 App-Only, OAuth 2.0 Authorization Code with PKCE, 또는 OAuth 1.0a User Context 인증 방식을 통해 요청을 인증해야 합니다. 단순화를 위해 이 예제 요청에는 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” 필드에 키와 토큰을 입력하세요. 설정이 올바르면 해당 변수는 요청의 authorization 탭에 자동으로 반영됩니다.   3단계: 검색 쿼리 생성 각 최근 검색 요청에는 하나의 검색 쿼리가 필요합니다. 이 예제에서는 @XDevelopers 계정이 게시한 게시물에 매칭되는 쿼리를 사용합니다. 이 쿼리에서는 from 연산자를 사용하고 값을 XDevelopers(대소문자 구분 없음)로 설정합니다: from:XDevelopers Postman에서 “Params” 탭으로 이동하여 이 ID 또는 쉼표로 구분한 게시물 ID 문자열을 ids 파라미터의 “Value” 열에 입력하세요.
KeyValueDescription
queryfrom:XDevelopers최근 검색 엔드포인트에 제출할 검색 쿼리
4단계: 가져올 필드 지정 3단계 후 “Send” 버튼을 클릭하면 응답에서 기본 Post object 필드인 id, text, edit_history_tweet_ids를 받게 됩니다. id, text, edit_history_tweet_ids 외 추가 필드를 받으려면 요청에서 field 및/또는 expansion 파라미터로 해당 필드를 지정해야 합니다. 이번 연습에서는 서로 다른 객체에서 다음 네 가지 필드 집합을 요청합니다:
  1. 기본 Post 객체의 기본 필드
  2. 게시물 객체에 추가 tweet.created_at 필드
  3. 반환된 게시물 작성자의 사용자 객체 기본 필드
  4. 관련 사용자 객체에 추가 user.description 필드
Postman에서 “Params” 탭으로 이동하여 “Query Params” 표에 다음 key:value 쌍을 추가하세요:
KeyValueReturned fields
tweet.fieldscreated_attweets.created_at
expansionsauthor_idincludes.users.id, includes.users.name, includes.users.username
user.fieldsdescriptionincludes.users.description
이제 “Send” 버튼 옆에 다음 URL이 표시되어야 합니다: https://api.x.com/2/tweets/search/recent?query=from:XDevelopers&tweet.fields=created_at&expansions=author_id&user.fields=created_at 5단계: 요청을 보내고 응답을 확인합니다 모든 설정을 마쳤다면 “Send” 버튼을 클릭하세요. 그러면 다음과 같은 응답을 받게 됩니다: 
{
   "data": [
       {
           "author_id": "2244994945",
           "created_at": "2020-06-11T16:05:06.000Z",
           "id": "1271111223220809728",
           "text": "오늘 밤 @jessicagarson이 여러분이 선호하는 Python 패키지를 R에서 실행하는 방법을 안내합니다. 🍿\n\n데이터 과학을 위한 두 가지 강력한 프로그래밍 언어를 함께 사용하는 방법을 배우고, X의 Developer Labs에서 최근 검색 엔드포인트를 사용하는 실시간 예제를 확인하세요. https://t.co/v178oUZNuj"
       },
       {
           "author_id": "2244994945",
           "created_at": "2020-06-10T19:25:24.000Z",
           "id": "1270799243071062016",
           "text": "새로운 X API를 구축하는 과정에서 여러 Labs v1 엔드포인트의 지원 중단 일정을 연장했습니다. 자세히 알아보기 📖 https://t.co/rRWaJYJgKk"
       },
       {
           "author_id": "2244994945",
           "created_at": "2020-06-09T18:08:47.000Z",
           "id": "1270417572001976322",
           "text": "주석을 사용하면 포스트에 대해 더 자세히 알 수 있으며, 관심 주제를 찾는 데에도 도움이 됩니다. 🔬\n\n이 튜토리얼에서 @suhemparack은 주석과 필터링된 스트림 엔드포인트를 사용하여 COVID-19 관련 포스트를 찾는 방법을 보여줍니다.\n\n여러분도 사용할 수 있는 방법을 알아보세요. ⤵️\nhttps://t.co/qwVOgw0zSV"
       }
   ],
   "includes": {
       "users": [
           {
               "description": "X #DevRel 팀의 목소리이자 X API에 대한 업데이트, 뉴스 및 이벤트에 대한 공식 소스입니다. \n\n#BlackLivesMatter",
               "id": "2244994945",
               "name": "X Developers",
               "username": "XDevelopers"
           }
       ]
   },
   "meta": {
       "newest_id": "1271111223220809728",
       "oldest_id": "1270417572001976322",
       "result_count": 3
   }
}
다음 단계 API Reference에서 요청을 커스터마이즈하세요 쿼리 연산자 전체 목록 보기 이 엔드포인트용 샘플 코드 사용