연동 가이드
개요
이 페이지에는 최신 또는 전체 아카이브 게시물 수 엔드포인트를 시스템에 통합할 때 알아두어야 할 여러 도구와 핵심 개념에 대한 정보가 포함되어 있습니다. 이 페이지는 다음 섹션으로 구성됩니다:
몇 가지 핵심 개념을 살펴보기 전에, 이러한 엔드포인트의 기능을 테스트해 보기 위해 아래 도구나 코드 샘플 중 하나를 사용하는 것을 권장합니다.
선호하는 프로그래밍 언어로 이 엔드포인트들을 설정하는 데 도움이 되는 코드가 필요하신가요? 시작점으로 활용할 수 있는 다양한 코드 샘플을 GitHub 페이지에서 제공하며, Python 클라이언트도 포함되어 있습니다.
시작하는 데 도움이 되는 다양한 커뮤니티 서드파티 라이브러리를 활용하세요. v2 엔드포인트와 호환되는 라이브러리는 해당 버전 태그를 확인해 찾을 수 있습니다.
Postman은 이러한 엔드포인트를 시험해 볼 때 유용한 도구입니다. 각 Postman 요청에는 해당 엔드포인트의 모든 매개변수가 포함되어 있어 사용 가능한 옵션을 빠르게 파악하는 데 도움이 됩니다. Postman 컬렉션에 대해 자세히 알아보려면 Using Postman 페이지를 방문하세요.
모든 X API v2 엔드포인트에 대한 요청은 키와 토큰으로도 불리는 자격 증명을 통해 인증되어야 합니다. 이 엔드포인트는 OAuth 2.0 베어러 토큰 사용이 필요하며, 즉 요청을 성공적으로 수행하려면 베어러 토큰을 전달해야 합니다. 베어러 토큰은 Developer 앱에서 직접 생성하거나, POST oauth2/token 엔드포인트를 사용해 생성할 수 있습니다.
X API v2 엔드포인트를 사용하려면 개발자 계정을 보유하고, 해당 계정 내에 프로젝트를 설정한 뒤, 그 프로젝트 내에 Developer 앱을 생성해야 합니다. 해당 Developer 앱의 키와 토큰은 최신 게시물 집계 엔드포인트에서 사용할 수 있습니다. 전체 보관 게시물 집계 엔드포인트를 사용하거나 고급 연산자와 더 긴 쿼리 길이를 활용하려면 엔터프라이즈 액세스 승인이 필요합니다.
자세한 내용은 엔터프라이즈 액세스 섹션을 방문해 주세요.
매일 수천 명의 개발자가 X API에 요청을 보냅니다. 트래픽을 관리하기 위해 각 엔드포인트에는 요청 한도가 적용되며, 이를 통해 앱 또는 인증된 사용자를 대신해 각 개발자가 보낼 수 있는 요청 수가 제한됩니다.
이 엔드포인트는 앱 수준(App-level)에서 요청 한도가 적용됩니다. 즉, 개발자는 사용 중인 자격 증명으로 식별되는 특정 앱마다, 주어진 기간 동안 이 엔드포인트로 보낼 수 있는 요청 수에 제한을 받습니다.
이 엔드포인트의 핵심 기능은 단일 쿼리를 사용하여 게시물을 필터링하고 제공할 집계 결과를 산출하는 것입니다. 이러한 쿼리는 메시지 키워드, 해시태그, URL 등 게시물 및 사용자 속성과 일치시키는 연산자로 구성됩니다. 연산자는 불리언 논리와 괄호를 사용해 조합하여 쿼리의 매칭 동작을 더욱 정교하게 조정할 수 있습니다.
쿼리 작성 방법 가이드를 참고하여 더 알아보세요.
최근 게시물 수의 경우 next_token이 반환되지 않습니다. 이는 세분화 수준과 관계없이 하나의 API 호출로 지난 7일간의 게시물 수를 받게 됨을 의미합니다.
전체 아카이브 게시물 수의 경우 지난 30일간의 데이터를 받게 됩니다. 30일을 초과하는 데이터에 대해서는 next_token이 반환되며, 이를 사용해 페이지네이션하여 추가 데이터를 가져올 수 있습니다.
게시물 수 엔드포인트는 GET 요청으로 단일 쿼리를 받아 해당 쿼리와 일치하는 과거 게시물 수를 반환합니다. 쿼리는 다양한 게시물 속성을 매칭하기 위한 연산자들로 구성됩니다.