메인 콘텐츠로 건너뛰기
이 페이지에는 게시물 조회 엔드포인트를 시스템에 통합하는 데 도움이 되는 여러 도구와 핵심 개념에 대한 정보가 포함되어 있습니다. 이 페이지는 다음과 같은 섹션으로 구성되어 있습니다:

​
유용한 도구

핵심 개념을 살펴보기 전에 다음 도구에 먼저 익숙해지는 것을 권장합니다: Postman
Postman은 각 경로와 본문 매개변수를 포함해 엔드포인트를 시험해 보며 제공 기능을 파악하는 데 유용한 도구입니다. 자세한 내용은 Postman 시작 가이드를 참고하세요. 코드 샘플
선호하는 프로그래밍 언어별 코드 샘플은 GitHub 페이지에서 확인하세요. 서드파티 라이브러리
v2 엔드포인트와 호환되는 커뮤니티 제작 서드파티 라이브러리를 활용하세요.

​
핵심 개념

​
인증

모든 X API v2 엔드포인트는 인증된 요청이 필요합니다. 다음 중 하나로 인증할 수 있습니다:
OAuth 1.0a는 구현이 까다로울 수 있습니다. 익숙하지 않다면 요청에 OAuth 2.0 또는 라이브러리 사용을 고려하세요. 비공개 메트릭이나 게시물을 다루는 경우에는 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE를 사용하세요.
참고
다음 필드를 요청하는 경우 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code가 필요합니다:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
개발자 포털, 프로젝트, 그리고 앱

X API v2의 자격 증명을 받으려면 다음이 필요합니다:
  1. 승인된 개발자 계정.
  2. 해당 개발자 계정 내의 프로젝트.
  3. 해당 프로젝트 내의 Developer 앱으로, 여기에서 키와 토큰을 확인할 수 있습니다.

​
요청 한도

X API 요청에는 트래픽 관리를 위해 요청 한도가 적용됩니다. 한도는 App 수준과 사용자 수준 모두에 적용됩니다:
  • App 수준: 어떤 앱이 일정 기간 내 수행할 수 있는 요청 수를 제한합니다.
  • 사용자 수준: 인증된 사용자가 Developer 앱 전반에서 게시물 조회를 수행할 수 있는 빈도를 제한합니다.

​
필드와 expansions

X API v2는 fields 및 expansions를 사용해 특정 데이터 필드를 선택할 수 있습니다:
  • Expansions: 추가로 관련 객체를 조회할 수 있게 합니다. 지원되는 expansions에는 다음이 포함됩니다:
    • edit_history_tweet_ids
    • attachments.poll_ids
    • attachments.media_keys
    • author_id
    • entities.mentions.username
    • geo.place_id
    • in_reply_to_user_id
    • referenced_tweets.id
    • referenced_tweets.id.author_id
  • Fields: 객체 내에서 반환할 데이터 필드를 지정해 추가 데이터를 제공합니다. 게시물 객체의 기본값은 id, text, edit_history_tweet_ids입니다. tweet.created_at, tweet.entities와 같은 다른 옵션은 명시적으로 요청해야 합니다.
자세한 내용은 X API v2 데이터 사전의 필드 및 expansions 가이드를 참조하세요.

​
게시물 편집

게시 가능한 게시물은 게시 후 30분 이내에 최대 5번까지 수정할 수 있습니다. 게시물 조회 엔드포인트는 항상 최신 버전의 게시물을 제공합니다. 거의 실시간에 가까운 사용 사례에서는 이 시간 범위를 유의하세요. 자세한 내용은 게시물 편집 기본 사항을 참조하세요.

​
예외 사례

  • 프로모션 지표: 프로모션되지 않은 게시물에 대해 프로모션 지표를 요청하면 빈 응답이 반환됩니다.
  • 잘린 텍스트: 리포스트의 경우 게시물 텍스트가 잘립니다. 전체 텍스트를 확인하려면 참조된 게시물을 펼치세요.