Skip to main content
このガイドでは、Search Posts エンドポイントをアプリケーションに統合するために必要な主要概念を扱います。

認証

Recent search は複数の認証方式をサポートします: Full-archive search は OAuth 2.0 App-Only 認証のみをサポートします。
Full-archive search では App-Only 認証のみをサポートするため、非公開メトリクス (non_public_metricsorganic_metricspromoted_metrics) は利用できません。

クエリを構築する

クエリは演算子を使って投稿にマッチします。ブールロジックで演算子を組み合わせます:

クエリ長の制限

演算子の種類

クエリを組み立てる

クエリ構文を詳しく学ぶ

演算子リファレンス

利用可能なすべての演算子を確認

Fields と expansions

デフォルトでは、レスポンスに idtextedit_history_tweet_ids のみが含まれます。パラメーターを使って追加データをリクエストします。

リクエスト例

cURL

利用可能な expansions

Fields と expansions ガイド

レスポンスのカスタマイズについて詳しく学ぶ

ページネーション

Search エンドポイントはページで結果を返します。レスポンスの next_token を使って追加ページを取得します。

しくみ

  1. max_results を指定して最初のリクエストを行う
  2. meta オブジェクトで next_token を確認
  3. 次のリクエストに next_token を含める
  4. next_token が返されなくなるまで繰り返す

cURL

ページネーションガイド

ページネーションについて詳しく学ぶ

投稿の編集

投稿は 30 分以内に最大 5 回まで編集できます。search エンドポイントは常に最新バージョンを返します。

考慮事項

  • edit_history_tweet_ids にはすべての投稿 ID が古い順に含まれます
  • 30 分の期間経過後に取得した投稿は最終バージョンを表します
  • ニアリアルタイムユースケースでは、公開直後の投稿がまだ編集される可能性があります

Edit Posts の基礎

投稿の編集について詳しく学ぶ

ベストプラクティス

具体的に始める

複数の演算子を使って結果を絞り込み、ノイズを減らします。

反復的にテストする

広めに開始し、その結果に基づいて絞り込みます。

ページネーションを処理

大規模な結果セットに適切なページネーションを実装します。

結果をキャッシュ

繰り返しリクエストを避けるため、結果をローカルに保存します。

次のステップ

クエリを組み立てる

クエリ構文を習得

演算子リファレンス

利用可能なすべての演算子

ページネーション

大規模な結果セットを処理

API リファレンス

エンドポイントの完全なドキュメント