Yahoo!リアルタイム検索で最近の公開投稿を検索します。

現在の反応、トレンド、ハッシュタグ、アカウント指定検索、日本語圏の話題、 画像や動画付き投稿を探すときに使います。一般的な Web 検索や公式情報の確認には 使わないでください。

主な引数:

• query: 検索語です。"#hashtag", "-word", "A OR B", "ID:username", "@username", "URL:domain" などの検索演算子も使えます。

• sort: "latest" は新着順、"popular" は反応が多い投稿を優先します。

• media_type: "image", "video", "all" を指定できます。標準は "image" です。

• limit: 1 ページあたりの件数です。1 から 40 まで指定できます。

• pages: 取得するページ数です。1 から 25 まで指定できます。ページ数が増えるほど API へのリクエストも増えます。

• start: 取得開始位置です。

• since / until: Unix 秒、または ISO 8601 形式の日時を指定できます。

• output_format: 標準は "markdown" です。構造化データが必要なときは "compact_json"、詳しい整形済みデータが必要なときは "full_json"、元 API の レスポンス確認には "raw_json" を使います。

Markdown 出力の構造:

• H1 に検索語を表示します。

• 先頭の箇条書きに取得件数、推定総件数、検索条件を表示します。

• 投稿ごとに H3 を作り、著者、ISO 形式の投稿時刻、反応数、投稿リンクを表示します。

• 投稿本文は Yahoo 側の displayTextBody/displayText 由来で、引用として表示します。

• 外部リンクは Markdown の箇条書きで表示します。タイトルがある場合は title、 ない場合は display URL または URL を使います。

• メディア URL はラベルを繰り返さず、通常の箇条書きで表示します。