Skip to main content

​
Enterprise와 X API v2 비교

유사점
  • 페이지네이션
  • 시간대
  • 게시물 편집 이력 및 메타데이터 지원 
차이점
  • 엔드포인트 URL
  • App 및 Project 요구 사항
  • 제공되는 데이터 기간
  • 응답 데이터 포맷
  • HTTP 메서드
  • 요청 시간 포맷
  • 요청 파라미터
  • 필터링 연산자

​
유사점

페이지네이션 v2에는 since_id 및 until_id와 함께 게시물 ID를 사용하여 페이지를 탐색할 수 있게 해 주는 새로운 페이지네이션 매개변수 등 추가 페이지네이션 기능이 있지만, enterprise와 v2 모두 시간(fromDate 및 toDate는 enterprise에서, start_time 및 end_time은 v2에서)을 사용하여 페이지네이션할 수 있습니다.   시간대 페이지네이션 섹션에서 언급했듯이, enterprise와 v2 모두에서 시간을 사용해 서로 다른 데이터 페이지를 탐색할 수 있습니다. 두 경우 모두 이러한 매개변수를 사용할 때 시간대는 UTC를 사용합니다. 게시물 편집 이력 및 메타데이터 지원 두 버전 모두 편집 이력을 설명하는 메타데이터를 제공합니다. 자세한 내용은 검색 API 참조 문서와 게시물 편집 기본 개념 페이지를 참고하세요. 

​
차이점

엔드포인트 URL
  • Enterprise 엔드포인트:
    • 30일 - http://gnip-api.x.com/search/30day/accounts/:account_name/:label.json
    • 전체 아카이브 - http://gnip-api.x.com/search/fullarchive/accounts/:account_name/:label.json
  • X API v2 엔드포인트
    • 최근 (7일) - https://api.x.com/2/tweets/search/recent
    • 전체 아카이브 - https://api.x.com/2/tweets/search/all
App 및 Project 요구 사항 X API v2 엔드포인트를 사용할 때는 요청을 인증할 때 Project의 자격 증명을 사용해야 합니다. 모든 X API v1.1 엔드포인트는 App 또는 App에 연결된 App의 자격 증명을 사용할 수 있습니다.   사용 가능한 기간 Enterprise API와 X API v2 모두 전체 아카이브에 대해 필터링된 게시물 데이터를 가져올 수 있는 엔드포인트를 제공합니다. 그러나 X API v2에는 Enterprise API에서 제공하는 것과 같은 30일 기간 엔드포인트가 없습니다. 대신 앞서 언급한 전체 아카이브 또는 7일 기간 엔드포인트를 제공하며, 이는 Native Enriched to v2 및 Activity Streams to v2와 일치하여 Enterprise 필드를 새로운 v2 필드에 매핑하는 데 도움이 됩니다. 이 가이드는 또한 v2 요청에서 특정 필드를 반환받기 위해 함께 전달해야 하는 구체적인 expansions 및 fields 파라미터도 제공합니다.   응답 데이터 형식 Enterprise 응답 형식과 X API v2 형식의 가장 큰 차이점 중 하나는 페이로드에서 어떤 필드를 반환할지 선택하는 방식입니다. Enterprise Search API의 경우, 응답 필드의 상당수를 기본적으로 받게 되며, 그다음 파라미터를 사용해 페이로드에 반환되어야 하는 필드 또는 필드 집합을 지정할 수 있습니다. X API v2 버전은 기본적으로 게시물 id 및 text 필드만 제공합니다. 추가 필드나 객체를 요청하려면 fields 및 expansions 파라미터를 사용해야 합니다. 이러한 엔드포인트에서 요청한 게시물 필드는 모두 기본 게시물 객체에 포함됩니다. 확장된 사용자, 미디어, 설문 조사, 장소 객체 및 필드는 응답 내 includes 객체에 포함되어 반환됩니다. 그런 다음 게시물과 확장된 객체 모두에 있는 ID를 매칭하여, 확장된 객체를 다시 게시물 객체와 연결할 수 있습니다. 이 새로운 파라미터에 대해서는 각 가이드를 참고하시거나, fields 및 expansions 사용 방법에 관한 가이드를 추가로 읽어보시기를 권장합니다. 특정 필드를 요청하는 방식의 변경 외에도, X API v2는 API가 반환하는 객체(예: Post 및 user 객체)에 대해 새로운 JSON 설계를 도입하고 있습니다.
  • JSON 루트 레벨에서 표준 엔드포인트는 게시물 객체를 statuses 배열로 반환하는 반면, X API v2는 data 배열로 반환합니다.
  • Retweeted 및 Quoted “statuses”를 참조하는 대신, X API v2 JSON은 Retweeted 및 Quoted Tweets를 참조합니다. contributors 및 user.translator_type와 같은 많은 레거시 및 사용 중단 예정 필드는 제거되고 있습니다.
  • 게시물 객체의 favorites와 사용자 객체의 favourites를 모두 사용하는 대신, X API v2는 좋아요를 의미하는 용어인 like을 사용합니다.
  • X는 값이 없는 JSON 값(예: null)은 페이로드에 기록하지 않는 관례를 채택하고 있습니다. 게시물 및 사용자 속성은 null이 아닌 값을 가진 경우에만 포함됩니다.  
또한 게시물 객체에 다음과 같은 새로운 필드 집합을 도입했습니다.
  • conversation_id 필드
  • context 및 entities를 포함한 두 개의 새로운 annotations 필드
  • 여러 개의 새로운 metrics 필드
  • 특정 게시물에 누가 답글을 달 수 있는지를 보여 주는 새로운 reply_setting 필드
마지막으로 한 가지 더. Premium 응답은 루트 레벨에 requestParameters 객체를 포함하며, 이 객체에는 요청에 포함한 파라미터가 담겨 있습니다. 반면 v2 버전에는 루트 레벨에 meta 객체가 포함되며, 추가 결과 페이지가 있는 경우 newest_id, oldest_id, result_count, next_token을 포함합니다. HTTP 메서드 Enterprise 버전 API에서는 요청을 JSON 본문을 포함한 POST HTTP 메서드로 보내거나, 쿼리 문자열을 사용하는 GET HTTP 메서드로 보낼 수 있습니다. V2에서는 쿼리 문자열을 사용하는 GET HTTP 메서드만 사용할 수 있습니다.   요청 시간 형식 이 엔드포인트의 Enterprise 버전은 페이지네이션 매개변수와 timePeriod 응답 필드 모두에서 다음과 같은 날짜/시간 형식을 사용합니다: YYYYMMDDHHmm V2 엔드포인트는 페이지네이션 매개변수와 start 및 end 응답 필드 모두에서 ISO 8601/RFC 3339 날짜/시간 형식을 사용합니다: YYYY-MM-DDTHH:mm:ssZ   요청 매개변수 다음은 Enterprise와 X API v2에 대한 요청 매개변수 표입니다: 필터링 연산자 Enterprise와 X API v2 간 연산자는 대부분 동일하지만, 연산자 사용 가능 여부에 몇 가지 차이가 있으며 X API v2에서만 제공되는 새로운 연산자도 일부 있습니다. X API v2, Enterprise, 그리고 premium 및 standard에서 사용할 수 있는 연산자 전체 표를 보려면 Search Posts migration landing page를 방문하세요. 다음 단계 X API v2 전체 보관 검색을 위한 빠른 시작 가이드 확인하기 전체 보관 검색용 API 참조 문서 검토하기 이 엔드포인트에 대한 샘플 코드 살펴보기