X API のポスト件数エンドポイントの比較
直近の投稿数の比較
| 説明 | Enterprise | X API v2 |
|---|---|---|
| ホストドメイン | https://gnip-api.x.com | https://api.x.com |
| エンドポイントパス | /search/30day/accounts/:account_name/:label/counts.json | /2/tweets/counts/recent |
| 認証 | Basic 認証 | OAuth 2.0 ベアラートークン |
| タイムスタンプ形式 | YYYYMMDDhhmm | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| カウント対象となる投稿の最大経過期間 | 31 日 | 7 日 |
| 戻されるのはどの程度古くない投稿のカウントか | 31 days | 7 days |
| 対応している HTTP メソッド | GET | GET |
| デフォルトのレート制限 | 検索データおよびカウントリクエストの合計で 1 秒あたり 20 リクエスト 1 分あたりのレート制限は、契約書に記載されたパートナーごとの値により異なります。 | ユーザーごとに 15 分あたり 180 リクエスト App ごとに 15 分あたり 450 リクエスト |
| annotations を使ったフィルタリングのサポート | ✔ | |
| conversation_id を使ったフィルタリングのサポート | ✔ | |
| 投稿データ配列の JSON キー名 | results | data |
| 時間の粒度 | 日、時間、または分 | 日、時間、または分 |
| タイムゾーン | UTC | UTC |
| 取得期間を指定するためのリクエストパラメータ | fromDate toDate | start_time end_time |
| 投稿 ID によるナビゲーションのためのリクエストパラメータ | since_id until_id | |
| project に関連付けられた developer App の認証情報の使用が必要 | ✔ |
フルアーカイブのポスト数の比較
| 説明 | Enterprise | X API v2 |
|---|---|---|
| ホストドメイン | https://gnip-api.x.com | https://api.x.com |
| エンドポイントパス | /search/fullarchive/accounts/:account_name/:label/counts | /2/tweets/counts/all |
| 認証 | Basic 認証 | OAuth 2.0 ベアラートークン |
| タイムスタンプ形式 | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| 返されるポスト数の対象となる最も古い期間 | 2006年3月以降のフルアーカイブ | 2006年3月以降のフルアーカイブ |
| 対応するHTTPメソッド | GET POST | GET |
| デフォルトのリクエストレート制限 | 1分あたりのレート制限は、契約で指定されたとおりパートナーごとに異なります。 1秒あたり20リクエスト | Appごとに15分あたり300リクエスト Appごとに1秒あたり1リクエスト |
| 粒度 | 日、時、分 | 日、時、分 |
| annotations を使用したフィルタリングのサポート | ✔ | |
| conversation_id を使用したフィルタリングのサポート | ✔ | |
| ポストデータ配列のJSONキー名 | results | data |
| 期間を指定するためのリクエストパラメータ | fromDate toDate | start_time end_time |
| ポストIDによるナビゲーション用リクエストパラメータ | since_id until_id | |
| ページネーション用JSONキー名 | next | meta.next_token |
| ページネーション用リクエストパラメータ | next_token | next_token または pagination_token |
| タイムゾーン | UTC | UTC |
| Academic Research access を持つ Project に関連付けられた developer App の認証情報の使用が必要 | ✔ |
フィルタリングオペレーターの比較
- Enterprise オペレーターにサブティアはありません。すべての Enterprise オペレーターは、すべての Enterprise ユーザーが利用できます。
- Core: これらのオペレーターは、すべての v2 ユーザーが利用できます。
- Advanced: これらのオペレーターは、Academic Research アクセスが承認されたユーザーのみが利用できます。
| Enterprise | v2 | |
|---|---|---|
| keyword | 利用可能 | Core |
| emoji | 利用可能 | Core |
| “exact phrase” | 利用可能 | Core |
| # | 利用可能 | Core |
| $ | 利用可能 | Advanced |
| @ | 利用可能 | Core |
| from: | 利用可能 | Core |
| to: | 利用可能 | Core |
| url: | 利用可能 | Core |
| retweets_of: | 利用可能 | Core |
| context: | Core | |
| entity: | Core - recent search でのみ利用可能 | |
| conversation_id: | Core | |
| place: | 利用可能 | Advanced |
| place_country: | 利用可能 | Advanced |
| point_radius: | 利用可能 | Advanced |
| bounding_box: | 利用可能 | Advanced |
| is:retweet | 利用可能 | Core |
| is:reply | 利用可能 | Core |
| is:quote | 利用可能 | Core |
| is:verified | 利用可能 | Core |
| -is:nullcast | 利用可能 | Advanced |
| has:hashtags | 利用可能 | Core |
| has:cashtags | 利用可能 | Advanced |
| has:links | 利用可能 | Core |
| has:mentions | 利用可能 | Core |
| has:media | 利用可能 | Core |
| has:images | 利用可能 | Core |
| has:videos | 利用可能 | Core |
| has:geo | 利用可能 | Advanced |
| lang: | 利用可能 | Core |
| list: | Advanced | |
| has:profile_geo | 利用可能 | |
| profile_country | 利用可能 | |
| profile_locality | 利用可能 | |
| profile_region | 利用可能 | |
| proximity | 利用可能 |