Enterprise와 X API v2 비교
- 페이지네이션
- 시간대
- 게시물 편집 이력 및 메타데이터 지원
- 엔드포인트 URL
- App 및 Project 요구 사항
- 제공되는 데이터 기간
- 응답 데이터 포맷
- HTTP 메서드
- 요청 시간 포맷
- 요청 파라미터
- 필터링 연산자
유사점
since_id 및 until_id와 함께 게시물 ID를 사용하여 페이지를 탐색할 수 있게 해 주는 새로운 페이지네이션 매개변수 등 추가 페이지네이션 기능이 있지만, enterprise와 v2 모두 시간(fromDate 및 toDate는 enterprise에서, start_time 및 end_time은 v2에서)을 사용하여 페이지네이션할 수 있습니다.
시간대
페이지네이션 섹션에서 언급했듯이, enterprise와 v2 모두에서 시간을 사용해 서로 다른 데이터 페이지를 탐색할 수 있습니다. 두 경우 모두 이러한 매개변수를 사용할 때 시간대는 UTC를 사용합니다.
게시물 편집 이력 및 메타데이터 지원
두 버전 모두 편집 이력을 설명하는 메타데이터를 제공합니다. 자세한 내용은 검색 API 참조 문서와 게시물 편집 기본 개념 페이지를 참고하세요.
차이점
- 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
- 30일 -
- X API v2 엔드포인트
- 최근 (7일) -
https://api.x.com/2/tweets/search/recent - 전체 아카이브 -
https://api.x.com/2/tweets/search/all
- 최근 (7일) -
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필드
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 | Search Posts v2 |
|---|---|
| query | query |
| maxResults | max_results |
| fromDate (YYMMDDHHmm) | start_time (YYYY-MM-DDTHH:mm:ssZ) |
| toDate (YYMMDDHHmm) | end_time (YYYY-MM-DDTHH:mm:ssZ) |
| since_id | |
| until_id | |
| next | next_token or pagination_token |