X API の Post 件数エンドポイントの比較
直近のPost件数の比較
| 説明 | エンタープライズ | X API v2 |
|---|---|---|
| ホストドメイン | https://gnip-api.x.com | https://api.x.com |
| エンドポイントパス | /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 |
| 返されるPost件数の対象となる最も古い期間 | 31日 | 7日 |
| 対応HTTPメソッド | GET | GET |
| 既定のリクエストレート制限 | 1秒あたり20リクエスト（検索データおよび件数リクエストで合算） 1分あたりのレート制限は、契約で指定されたとおりパートナーごとに異なります。 | 15分あたりユーザーごとに180リクエスト 15分あたりアプリごとに450リクエスト |
| annotations を使用したフィルタリングのサポート | ✔ | |
| conversation_id を使用したフィルタリングのサポート | ✔ | |
| Postのdata配列のJSONキー名 | results | data |
| 時間粒度 | 日、時間、または分 | 日、時間、または分 |
| タイムゾーン | UTC | UTC |
| 期間選択のためのリクエストパラメータ | fromDate toDate | start_time end_time |
| Post IDによるナビゲーションのためのリクエストパラメータ | since_id until_id | |
| project に関連付けられたdeveloper Appの認証情報の使用が必要 | ✔ |
全アーカイブのPost件数の比較
| 説明 | エンタープライズ | X API v2 |
|---|---|---|
| ホストドメイン | https://gnip-api.x.com | https://api.x.com |
| エンドポイントパス | /search/fullarchive/accounts/:account_name/:label/counts | /2/tweets/counts/all |
| 認証 | ベーシック認証 | OAuth 2.0 ベアラートークン |
| タイムスタンプ形式 | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| 返されるPost件数の対象期間（最古） | 2006年3月以降の全アーカイブ | 2006年3月以降の全アーカイブ |
| 対応HTTPメソッド | GET POST | GET |
| 既定のリクエストレート制限 | 1分あたりのレート制限は、契約に記載のとおりパートナーごとに異なります。 1秒あたり20リクエスト | アプリあたり15分で300リクエスト アプリあたり1秒で1リクエスト |
| 粒度 | 日、時、分 | 日、時、分 |
| annotations を使ったフィルタリングに対応 | ✔ | |
| conversation_id を使ったフィルタリングに対応 | ✔ | |
| Postのデータ配列の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 に関連付けられた developer App の認証情報の使用が必要 | ✔ |
フィルタリング演算子の比較
- エンタープライズ演算子にサブ階層はありません。すべてのエンタープライズユーザーが、すべてのエンタープライズ演算子を利用できます。
- Core: これらの演算子は、すべての v2 ユーザーが利用できます。
- Advanced: これらの演算子は、Academic Research アクセスの承認を受けたユーザーのみが利用できます。
| エンタープライズ | 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 |