X API の Post 件数 endpoint の比較
v2 の Post 件数 endpoint は最終的に Enterprise Search API の counts endpoint に代わる予定です。既存のコード、App、またはツールで旧バージョンの Post 件数 endpoint を使用しており、新しい X API v2 の endpoint への移行を検討している場合は、このガイドをご参照ください。 このページには次の比較表が含まれます:直近のPost件数の比較
Post件数のendpointのEnterprise版では、30日分またはフルアーカイブから件数を取得できます。したがって、7日間を対象とするv2の直近Post件数endpointは、前述のいずれのendpointの直接的な代替にはなりません。 ただし、比較の助けとして、v2の直近Post件数endpointがEnterpriseの30日endpointとどのように異なるかを見ていきます。 次の表は、各種の直近Post件数endpointを比較したものです。| 説明 | Enterprise | X API v2 |
|---|---|---|
| ホストドメイン | https://gnip-api.x.com | https://api.x.com |
| endpointパス | /search/30day/accounts/:account_name/:label/counts.json | /2/tweets/counts/recent |
| Authentication | Basic authentication | OAuth 2.0 Bearer Token |
| タイムスタンプ形式 | YYYYMMDDhhmm | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| 返されるPostsの上限期間（最古） | 31 days | 7 days |
| 対応するHTTP メソッド | GET | GET |
| 既定のリクエストのレートリミット | 1秒あたり20件（検索データと件数リクエストの合算） 1分あたりのレートリミットは、契約で定められたとおりパートナーごとに異なります。 | 15分あたりユーザーごとに180リクエスト 15分あたりAppごとに450リクエスト |
| annotationsによるフィルタリングのサポート | ✔ | |
| conversation_idによるフィルタリングのサポート | ✔ | |
| Postのdata配列のJSONキー名 | results | data |
| 時間粒度 | 日、時、分 | 日、時、分 |
| タイムゾーン | UTC | UTC |
| 期間選択のリクエストパラメータ | fromDate toDate | start_time end_time |
| Post IDによるナビゲーションのリクエストパラメータ | since_id until_id | |
| developer Appの認証情報をprojectに関連付けて使用する必要がある | ✔ |
全アーカイブのPost件数の比較
次の表は、各種の全アーカイブ検索endpointの比較です。| 説明 | Enterprise | X API v2 |
|---|---|---|
| ホストドメイン | https://gnip-api.x.com | https://api.x.com |
| Endpoint パス | /search/fullarchive/accounts/:account_name/:label/counts | /2/tweets/counts/all |
| 認証 | Basic auth | OAuth 2.0 Bearer Token |
| タイムスタンプ形式 | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| 返されるPost件数の対象範囲（最古） | 2006年3月以降の全アーカイブ | 2006年3月以降の全アーカイブ |
| 対応するHTTP メソッド | GET POST | GET |
| 既定のリクエストのレートリミット | 1分あたりのレートリミットは、契約に明記されたとおりパートナーごとに異なります。 毎秒20リクエスト | Appあたり15分で300リクエスト Appあたり毎秒1リクエスト |
| 粒度 | 日、時、分 | 日、時、分 |
| annotations によるフィルタリング | ✔ | |
| conversation_id によるフィルタリング | ✔ | |
| Postのdata配列のJSONキー名 | results | data |
| 期間指定のリクエストパラメータ | fromDate toDate | start_time end_time |
| Post IDによるナビゲーション用のリクエストパラメータ | since_id until_id | |
| ページネーションのJSONキー名 | next | meta.next_token |
| ページネーション用のリクエストパラメータ | next_token | next_token または pagination_token |
| タイムゾーン | UTC | UTC |
| Academic Research access を有する Project に紐づく開発者用 App の認証情報が必要 | ✔ |
フィルタリング演算子の比較
2 つの異なるバージョン（Enterprise と v2）の Post 件数は、利用可能な演算子が異なり、各バージョン内でも演算子の提供レベルが異なります。以下で説明します。 Enterprise- Enterprise 演算子にサブティアはありません。すべての Enterprise ユーザーが、すべての Enterprise 演算子を利用できます。
- Core: これらの演算子は、すべての v2 ユーザーが利用できます。
- Advanced: これらの演算子は、Academic Research アクセスが承認されたユーザーのみが利用できます。
| Enterprise | v2 | |
|---|---|---|
| keyword | Available | Core |
| emoji | Available | Core |
| “exact phrase” | Available | Core |
| # | Available | Core |
| $ | Available | Advanced |
| @ | Available | Core |
| from: | Available | Core |
| to: | Available | Core |
| url: | Available | Core |
| retweets_of: | Available | Core |
| context: | Core | |
| entity: | Core - Only available with recent search | |
| conversation_id: | Core | |
| place: | Available | Advanced |
| place_country: | Available | Advanced |
| point_radius: | Available | Advanced |
| bounding_box: | Available | Advanced |
| is:retweet | Available | Core |
| is:reply | Available | Core |
| is:quote | Available | Core |
| is:verified | Available | Core |
| -is:nullcast | Available | Advanced |
| has:hashtags | Available | Core |
| has:cashtags | Available | Advanced |
| has:links | Available | Core |
| has:mentions | Available | Core |
| has:media | Available | Core |
| has:images | Available | Core |
| has:videos | Available | Core |
| has:geo | Available | Advanced |
| lang: | Available | Core |
| list: | Advanced | |
| has:profile_geo | Available | |
| profile_country | Available | |
| profile_locality | Available | |
| profile_region | Available | |
| proximity | Available |