Skip to main content

X API의 Posts lookup 엔드포인트 비교

v2 Posts lookup 엔드포인트는 standard v1.1 GET statuses/lookupGET statuses/show 엔드포인트를 대체합니다. 이 가이드는 이러한 이전 버전에서 X API v2로 마이그레이션하는 개발자를 위한 것입니다.

엔드포인트 비교표


Standard v1.1과 X API v2 비교

standard v1.1 GET statuses/show 및 GET statuses/lookup을 사용해 왔다면, 이 가이드는 standard와 X API v2 Posts lookup 엔드포인트의 공통점과 차이점을 이해하는 데 도움이 됩니다. X API v1.1 데이터 형식X API v2 형식의 차이점을 빠르게 확인할 수 있는 시각적 데이터 형식 마이그레이션 도구도 참고하세요.
  • 공통점
    • OAuth 1.0a User Context
    • 요청당 게시물 수 제한
    • Post 편집 히스토리 및 메타데이터 지원
  • 차이점
    • 엔드포인트 URL
    • App 및 Project 요구사항
    • 응답 데이터 형식
    • 요청 파라미터

공통점

OAuth 1.0a User Context 인증 방식

standard 엔드포인트는 OAuth 1.0a User Context를 지원하며, 새로운 X API v2 Post lookup 엔드포인트는 OAuth 1.0a User Context와 OAuth 2.0 App-Only를 모두 지원합니다. 따라서 이전에 standard v1.1 Post lookup 엔드포인트 중 하나를 사용하고 있었다면, X API v2 버전으로 마이그레이션하더라도 동일한 인증 방식을 계속 사용할 수 있습니다. App-Only 인증이 아마도 시작하기 가장 쉬운 방법일 것입니다. App Access Token 생성 방법은 이 OAuth 2.0 App-only 가이드를 참고하세요.

요청당 게시물 수 제한

v1.1 GET statuses/lookup 엔드포인트는 요청당 최대 100개의 게시물을 지정할 수 있습니다. 이는 GET /tweets 엔드포인트에도 적용됩니다. 전체 100개의 게시물을 지정하려면 ids 파라미터를 쿼리 파라미터로 사용하고 Post ID를 쉼표로 구분된 목록으로 전달합니다. Post 편집 히스토리 및 메타데이터 지원 두 버전 모두 편집 히스토리를 설명하는 메타데이터를 제공합니다. 자세한 내용은 Post lookup API 레퍼런스와 Edit Posts 기본 페이지를 참고하세요.

차이점

엔드포인트 URL

  • Standard v1.1 엔드포인트:
    • https://api.x.com/1.1/statuses/show
    • https://api.x.com/1.1/statuses/lookup
  • X API v2 엔드포인트:
    • https://api.x.com/2/tweets
    • https://api.x.com/2/tweets/:id

App 및 Project 요구사항

X API v2 엔드포인트는 인증을 위해 Project에 연결된 developer App의 자격 증명을 요구합니다. X API v1.1 엔드포인트는 App의 자격 증명이나 App에 연결된 App의 자격 증명을 사용할 수 있습니다.

응답 데이터 형식

standard v1.1과 X API v2 엔드포인트 버전의 중요한 차이 중 하나는 페이로드에서 필드가 선택되는 방식입니다. standard 엔드포인트의 경우 많은 응답 필드가 기본적으로 포함되며, 파라미터로 추가 필드를 지정할 수 있습니다. 반면 X API v2는 기본적으로 Post idtext 필드만 전달합니다. 추가 필드와 객체를 사용하려면 fieldsexpansions 파라미터를 사용해야 합니다. 확장된 필드는 응답의 includes 객체로 반환되며, ID를 매칭하여 기본 Post 객체와 연결할 수 있습니다. fields와 expansions 사용에 대한 자세한 내용은 fields와 expansions 사용법 가이드를 참고하세요. 데이터 형식 마이그레이션 가이드도 standard v1.1 필드를 새로운 v2 필드에 매핑합니다. 또한 X API v2는 Post 및 user 객체를 포함한 객체에 새로운 JSON 설계를 도입합니다:
  • standard 엔드포인트는 statuses 배열에 Post 객체를 반환하지만, X API v2는 data 배열을 사용합니다.
  • X API v2에서는 “statuses” 용어 대신 Retweeted 및 Quoted Tweets를 사용합니다.
  • like 같은 새로운 용어가 favoritesfavourites 같은 용어를 대체합니다.
  • 값이 없는(예: null) 속성은 X API v2 페이로드에 포함되지 않습니다.
X API v2의 Post 객체에는 다음과 같은 새로운 필드가 포함됩니다:
  • conversation_id
  • 두 개의 새로운 annotations 필드(contextentities)
  • 새로운 metrics 필드
  • 특정 게시물에 누가 답글을 달 수 있는지 보여주는 reply_setting 필드

요청 파라미터

다음 standard v1.1 요청 파라미터는 X API v2에 동등한 것이 있습니다: X API v2에서 지원되지 않는 특정 standard v1.1 파라미터가 있습니다:

cURL 요청

다음 cURL 요청은 standard v1.1 엔드포인트와 그 v2 대응 엔드포인트를 보여줍니다. 헤더의 ACCESS_TOKEN을 app access token으로 교체하세요. v2 엔드포인트의 경우 토큰은 Project 내 developer App에 속해야 합니다. v1.1의 응답 페이로드는 v2와 다릅니다. v2에서는 fieldsexpansions 파라미터로 다른 필드를 요청할 수 있습니다. Standard v1.1 GET statuses/lookup과 v2 GET /tweets 엔드포인트
Standard v1.1 GET statuses/show/:id과 v2 GET /tweets/:id 엔드포인트