Enterprise와 X API v2 비교
- 세분화 수준
- 페이지네이션
- 시간대
- 엔드포인트 URL
- App 및 Project 요구 사항
- 사용 가능한 기간
- 응답 데이터 형식
- HTTP 메서드
- 요청 시간 형식
- 요청 매개변수
- 필터링 연산자
유사점
bucket, v2 버전은 granularity), 해당 파라미터에 전달할 수 있는 값과 기본 동작은 동일합니다.
dayhour(기본값)minute
since_id 및 until_id를 사용해 게시물 ID 기준으로 탐색할 수 있는 새로운 페이지네이션 파라미터). 하지만 enterprise와 v2 모두 시간 기준으로 페이지네이션을 지원합니다(enterprise는 fromDate 및 toDate, v2는 start_time 및 end_time).
enterprise 버전을 사용하는 경우, 페이지네이션을 위해 next 파라미터를 사용하며, 다음 토큰 필드는 next라는 이름을 가지며 응답의 루트에 위치합니다.
v2를 사용하는 경우, 페이지네이션을 위해 next_token 또는 pagination_token 파라미터를 사용할 수 있으며, 다음 토큰은 응답의 meta.next_token 위치에 있습니다.
시간대(Timezone)
페이지네이션 섹션에서 언급했듯이, enterprise와 v2 모두 시간 기준으로 서로 다른 페이지의 데이터를 탐색할 수 있습니다. 두 경우 모두 이러한 파라미터를 사용할 때 시간대는 UTC를 사용합니다.
차이점
- Enterprise 엔드포인트:
- 30일 -
http://gnip-api.x.com/search/30day/accounts/:account_name/:label/counts.json - 전체 아카이브 -
http://gnip-api.x.com/search/fullarchive/accounts/:account_name/:label/counts.json
- 30일 -
- X API v2 엔드포인트
- 최근 (7일) -
https://api.x.com/2/tweets/counts/recent - 전체 아카이브 -
https://api.x.com/2/tweets/counts/all
- 최근 (7일) -
- Enterprise의 카운트 데이터는
results객체 내에 위치하는 반면, v2 카운트 데이터는data객체 내에 위치합니다. - Enterprise의 카운트 필드 이름은
timePeriod(시작 시간)와count인 반면, v2는 기간을start및end필드로 분리합니다(요청 시간 형식에서 설명한 것처럼 enterprise와는 다른 날짜/시간 형식을 사용하며),count필드 이름은tweet_count로 변경합니다. - Enterprise 메타데이터에는 루트 레벨에
totalCount,next,requestParameters객체가 포함됩니다. 반면 v2는requestParameters객체를 포함하지 않고, 다음 필드를 루트 레벨에 있는meta객체로 이동 및 이름 변경합니다:total_tweet_count및next_token.
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에서 사용 가능한 연산자의 전체 표를 보려면 Post counts migration 랜딩 페이지를 방문하세요.