개요

이 페이지에서는 게시물 수 엔드포인트를 통합하는 데 필요한 도구와 핵심 개념을 설명합니다.

---

​

유용한 도구

몇 가지 핵심 개념을 살펴보기 전에, 이 엔드포인트의 기능을 테스트해 보기 위해 다음 도구나 코드 샘플 중 하나를 사용하실 것을 권장합니다.

​

코드 샘플

선호하는 프로그래밍 언어로 이 엔드포인트들을 바로 사용해 보고 싶으신가요? 시작점으로 활용할 수 있는 몇 가지 코드 샘플을 GitHub 페이지에서 제공하고 있으며, 여기에는 Python Client도 포함되어 있습니다.

​

라이브러리

시작할 때는 다양한 커뮤니티 서드파티 라이브러리를 활용하세요. 적절한 버전 태그를 확인하면 v2 엔드포인트와 호환되는 라이브러리를 찾을 수 있습니다.

​

Postman

Postman은 이 엔드포인트들을 테스트하는 데 사용할 수 있는 훌륭한 도구입니다. 각 Postman 요청에는 해당 엔드포인트에서 사용할 수 있는 모든 파라미터가 포함되어 있어, 어떤 항목을 사용할 수 있는지 빠르게 파악하는 데 도움이 됩니다. Postman 컬렉션에 대해 더 자세히 알아보려면 Postman 사용하기 페이지를 방문하세요.

---

​

핵심 개념

​

인증

모든 X API v2 엔드포인트는 키와 토큰이라고도 불리는 자격 증명 세트로 인증된 요청이 필요합니다. 이 엔드포인트는 OAuth 2.0 Bearer 토큰의 사용을 요구하며, 이는 요청을 성공적으로 수행하려면 Bearer 토큰을 전달해야 함을 의미합니다. Bearer 토큰은 개발자 App 내에서 직접 생성하거나, POST oauth2/token 엔드포인트를 사용해 생성할 수 있습니다.

​

개발자 콘솔, Projects, 그리고 개발자 Apps

어떤 X API v2 엔드포인트를 사용하려면 개발자 계정이 있어야 하며, 해당 계정 내에 Project를 설정하고, 그 Project 안에 developer App을 생성해야 합니다. 해당 developer App에 있는 키와 토큰은 최근 게시물 개수 엔드포인트에서 사용할 수 있습니다. 전체 아카이브 게시물 개수 엔드포인트를 사용하거나 고급 연산자와 더 긴 쿼리 길이를 활용하려면 엔터프라이즈 액세스 권한 승인이 필요합니다.

자세한 내용은 엔터프라이즈 액세스 섹션을 참조하세요.

​

요청 한도

매일 수많은 개발자들이 X API에 요청을 보냅니다. 이러한 트래픽 규모를 관리하기 위해 각 엔드포인트에는 요청 한도가 설정되어 있으며, 이를 통해 각 개발자가 App을 대신하거나 인증된 사용자를 대신해 보낼 수 있는 요청 수가 제한됩니다.

이 엔드포인트에는 App 수준의 요청 한도가 적용됩니다. 이는 개발자인 여러분이 사용하는 자격 증명으로 식별되는 어떤 App에서든, 일정 기간 동안 이 엔드포인트로 보낼 수 있는 요청 수가 한정되어 있다는 뜻입니다.

​

쿼리 구성하기

이 엔드포인트의 핵심 기능은 하나의 쿼리를 사용해 게시물을 필터링하고, 그 결과를 집계된 개수로 제공하는 것입니다. 이러한 쿼리는 게시물과 사용자 속성(메시지 키워드, 해시태그, URL 등)에 일치하는 연산자로 구성됩니다. 연산자를 불리언 논리와 괄호와 함께 조합해 쿼리의 매칭 방식을 더욱 정교하게 조정할 수 있습니다.

자세한 내용은 쿼리 작성 방법 가이드를 참고하세요.

​

페이지네이션

최근 게시물 개수의 경우 next_token이 반환되지 않습니다. 이는 집계 단위와 관계없이 하나의 API 호출로 지난 7일간의 게시물 총량을 얻게 된다는 의미입니다.

전체 아카이브 게시물 개수의 경우, 지난 30일간의 데이터를 받게 됩니다. 30일을 초과하는 기간의 데이터에 대해서는 next_token이 제공되며, 이를 사용해 페이지네이션하여 추가 데이터를 가져올 수 있습니다.