> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 検索オペレーター
このページでは、Search v2 API のエンドポイントで[クエリを構築する](/ja/x-api/posts/search/integrate/build-a-query)際に利用できるオペレーターを一覧で示します。
## 演算子の一覧
**注記:** 一部の演算子には、別名 (エイリアス) が用意されています。
| **オペレーター** | **Type** | **説明** | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| :---------------------- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------------- | ----------------------------- | ----------- | --------------------- | ------------------------------ | ------------- | ------------- | -------------------------------- | ---------------- | ----------- | ---------------------------- | ----------- | ------------ | ------------------------------ | ------------ | ----------- | ----------------------------- | ------------------------ | ------------- | -------------------------- | ------------ | ------------ | ---------------------------- | ------------- | ----------- | --------------------------- | ------------- | ------------ | --------------------------- | ----------- | ------------ | --------------------------------- | --------- | ------------ | --------------------------- | ----------- | ---------- | -------------------------- | ----------- | ----------- | ------------------------------ | --------- | --------------- | ------------------------------ | --------- | ---------- | ---------------------------- | ----------- | ----------- | --------------------------------------- | ------------ |
| `keyword` | 単独で使用可 | ポスト本文内のキーワードにマッチします。これはトークン単位でのマッチであり、指定したキーワード文字列がポスト本文のトークン化されたテキストと照合されることを意味します。トークン化では、単語は句読点、記号、Unicode 基本多言語面の区切り文字に基づいて分割されます。
たとえば、「I like coca-cola」というテキストを含むポストは、次のトークンに分割されます: I, like, coca, cola。これらのトークンが、クエリで使用したキーワード文字列と比較されます。句読点 (たとえば coca-cola) 、記号、または区切り文字を含む文字列にマッチさせるには、キーワード全体を二重引用符で囲む必要があります。
例: `pepsi OR cola OR "coca cola"` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `emoji` | 単独で使用可 | ポスト本文内の絵文字にマッチします。キーワードと同様に、絵文字もトークン単位でマッチし、指定した絵文字はポスト本文のトークン化されたテキストと照合されます。
絵文字にバリアント (異なるバージョン) がある場合は、その絵文字をクエリに追加する際にダブルクォーテーションで囲む必要がある点に注意してください。
例: `(😃 OR 😡) 😬` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `"exact phrase match"` | 単独で使用可 | ポスト本文中のフレーズと完全一致する場合にマッチします。
例: `("X API" OR #v2) -"recent search"` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `#` | 単独で使用可 | ハッシュタグがポスト内でエンティティとして認識されている場合、そのハッシュタグを含む任意のポストにマッチします。
このオペレーターはトークン化された一致ではなく、完全一致を行います。つまり、ルール `#thanku` はハッシュタグ #thanku と完全に一致する投稿にはマッチしますが、ハッシュタグ #thankunext を含む投稿にはマッチしません。
例: `#thankunext #fanart OR @arianagrande` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `@` | 単独で使用可 | 指定したユーザー名が認識済みのエンティティである場合 (@文字を含む) 、そのユーザー名への言及を含む任意のポストにマッチします。
例：`(@XDevelopers OR @API) -@X` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `$` | 単独で使用可 | 指定された「cashtag」 (トークンの先頭文字が $ であるもの) を含む任意のポストにマッチします。
なお、cashtag 演算子は、ポスト本文から cashtag を直接抽出しようとするのではなく、X の「symbols」エンティティ抽出機能に基づいて cashtag をマッチさせます。
例: `$twtr OR @XDevelopers -\$fb\` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `from:` | 単独で使用可 | 特定のユーザーによるポストすべてに一致します。
値には、ユーザー名 (@ 文字を除く) またはそのユーザーの数値 ID を指定できます。
`from:` 演算子ごとに指定できる username/ID は 1 つだけです。
例: `from:XDevelopers OR from:API -from:X` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `to:` | 単独で使用可 | 特定のユーザーに対する返信であるポストすべてにマッチします。
値には、ユーザー名 (@文字を除く) またはユーザーの数値のユーザーIDを指定できます。
`to:` オペレーターごとに指定できるユーザー名/ID は 1 つだけです。
例: `to:XDevelopers OR to:API -to:X` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `url:` | 単独で使用可 | ポスト内の正しい形式の任意の URL に対して、トークン単位でマッチングを行います。
このオペレーターは、`url` フィールドと `expanded_url` フィールドの両方の内容にマッチします。たとえば、「You should check out X Developer Labs: [https://t.co/c0A36SWil4」](https://t.co/c0A36SWil4」) (短縮 URL が [https://developer.twitter.com](https://developer.twitter.com) にリダイレクトされるもの) を含むポストは、次の両方のルールにマッチします。
`from:XDevelopers url:"https://developer.twitter.com"` (`entities.urls.expanded_url` の内容にマッチするため)
`from:XDevelopers url:"https://t.co"` (`entities.urls.url` の内容にマッチするため)
句読点や特殊文字を含むトークンやフレーズは、二重引用符で囲む必要があります (例: `url:"/developer"`) 。同様に、特定のプロトコルにマッチさせる場合も、二重引用符で囲みます (例: `url:"https://developer.twitter.com"`) 。 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `retweets_of:` | 単独で使用可 | 指定したユーザーのリツイートである投稿に一致します。値として指定できるのは、ユーザー名 (@ 文字を除く) か、ユーザーの数値のユーザーIDのいずれかです。
`retweets_of:` 演算子ごとに指定できるユーザー名/IDは1つまでです。
例: `retweets_of:twitterdev OR retweets_of:twitterapi` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `in_reply_to_tweet_id:` | 単独で使用可 | *利用可能なエイリアス：* `in_reply_to_status_id:`
指定されたポストへの返信にマッチします。
例：`in_reply_to_tweet_id:1539382664746020864` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `retweets_of_tweet_id:` | 単独で使用可 | *使用可能な別名:* `retweets_of_status_id:`
指定したポストの明示的 (ネイティブ) なリツイートに一致します。使用するポストIDは、リツイートではなく元のポストのIDである必要があります。
例: `retweets_of_tweet_id:1539382664746020864` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `quotes_of_tweet_id:` | 単独で使用可 | *利用可能なエイリアス:* `quotes_of_status_id:`
指定したポストの引用ツイートに一致します。指定する Post ID は、引用ツイートではなく元のポストの ID である必要があります。
例: `quotes_of_tweet_id:1539382664746020864` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `context:` | 単独で使用可 | 特定の domain id/entity id のペアに一致する投稿を検索します。このオペレーターの詳細については、[annotations](/ja/x-api/fundamentals/post-annotations) のページをご覧ください。
`context:` オペレーターごとに指定できる domain/entity は 1 つだけです。
`context:domain_id.entity_id`
ただし、OR 演算子を使って複数の domain/entity を組み合わせることができます。
`(context:47.1139229372198469633 OR context:11.1088514520308342784)`
例:
`context:10.799022225751871488` (`domain_id.entity_id` によって、その特定の domain/entity のペアに一致する投稿が返されます) | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `entity:` | 単独で使用可 | 特定のエンティティ文字列値を持つ投稿にマッチします。このオペレーターの詳細については、[annotations](/ja/x-api/fundamentals/post-annotations) のページをご覧ください。
**注意**：これは recent search でのみ利用可能です。
`entity:` オペレーターは 1 つだけ指定できます。
`entity:"string declaration of entity/place"`
例: `entity:"Michael Jordan" OR entity:"Barcelona"` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `conversation_id:` | 単独で使用可 | 共通の会話IDを持つ投稿に一致します。会話IDは、その会話を開始したポストのポストIDとして設定されます。ポストへの返信が投稿されると、その返信への返信も含めて、`conversation_id` がその JSON ペイロードに追加されます。
`conversation_id:` 演算子ごとに指定できる会話IDは1つだけです。
例: `conversation_id:1334987486343299072 (from:XDevelopers OR from:api)` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `list:` | 単独で使用可 | 指定したリストのメンバーであるユーザーが行った投稿に一致します。
たとえば、@XDevelopers と @api がリスト 123 のメンバーであり、クエリに `list:123` を含めた場合、レスポンスにはそれらのアカウントによって投稿されたもののみが含まれます。リスト ID は、[List lookup](/ja/x-api/lists/list-lookup/introduction) エンドポイントを使用して確認できます。
**注意**: 1 つのクエリで使用できる `list:` 演算子は 1 つだけであり、その `list:` 演算子につき指定できるリストも 1 つだけです。
例: `list:123` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `place:` | 単独で使用可 | 指定した位置情報またはXのplace IDがタグ付けされている投稿にマッチします。複数語からなる場所の名称 (“New York City”、“Palo Alto” など) は引用符で囲む必要があります。
`place:` 演算子ごとに指定できる場所は1つだけです。
注: Xのplace IDの取得方法については、標準 v1.1 の [GET geo/search](https://developer.x.com/content/developer-twitter/en/docs/geo/places-near-location/api-reference/get-geo-search) エンドポイントを参照してください。
注: この演算子はリツイートにはマッチしません。リツイートの場所情報は元のポストに紐づくためです。また、引用ツイートの元ポストに紐づいている場所情報にもマッチしません。
例: `place:"new york city" OR place:seattle OR place:fd70c22040963ac7` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `place_country:` | 単独で使用可 | タグ付けされた場所/ロケーションに関連付けられている国コードが、指定された ISO 2文字アルファベットコードと一致する投稿にマッチします。
有効な ISO コードの一覧は [Wikipedia](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) で確認できます。
`place_country:` 演算子につき、指定できる ISO コードは 1 つだけです。
注: この演算子はリツイートにはマッチしません。リツイートの場所情報は元のポストに紐付いているためです。また、引用ツイートの元ポストに紐付いている場所情報にもマッチしません。
例: `place_country:US OR place_country:MX OR place_country:CA` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `point_radius:` | 単独で使用可 | `place.geo.coordinates` オブジェクトが存在する場合には、そのオブジェクトを対象にポストを照合し、X 上では、定義した領域内に Place ポリゴン全体が含まれるような place のジオポリゴンを対象に照合します。
`point_radius:[longitude latitude radius]`
- サポートされる半径の単位はマイル (mi) とキロメートル (km) です
- 半径は 25mi 未満である必要があります
- 経度は ±180 の範囲です
- 緯度は ±90 の範囲です
- すべての座標は 10 進表記の度数です
- ルール引数は角括弧内に含め、スペース区切りにします
`point_radius:` 演算子ごとに指定できるジオポリゴンは 1 つだけです。
注意: この演算子はリツイートには一致しません。リツイートの場所情報は元のポストに紐づいているためです。また、引用ツイートの元ポストに紐づいた場所情報にも一致しません。
例: `point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi]` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `bounding_box:` | 単独で使用可 | *利用可能なエイリアス:* `geo_bounding_box:`
ポストに `place.geo.coordinates` オブジェクトが存在する場合はそのオブジェクトに対して、また X では place のジオポリゴンに対してマッチし、place のポリゴンが定義した領域内に完全に含まれている場合にマッチします。
`bounding_box:[west_long south_lat east_long north_lat]`
- `west_long south_lat` はバウンディングボックスの南西端を表し、`west_long` がその地点の経度、`south_lat` が緯度です。
- `east_long north_lat` はバウンディングボックスの北東端を表し、`east_long` がその地点の経度、`north_lat` が緯度です。
- バウンディングボックスの幅と高さは 25mi 未満である必要があります。
- 経度は ±180 の範囲内です。
- 緯度は ±90 の範囲内です。
- すべての座標は 10 進度 (decimal degrees) です。
- ルール引数は角括弧内に記述し、空白で区切ります。
`bounding_box:` オペレーターごとに渡せるジオポリゴンは 1 つだけです。
注意: このオペレーターはリツイートにはマッチしません。リツイートの place は元のポストに紐づいているためです。また、引用ツイートの元のポストに紐づいている place にもマッチしません。
例: `bounding_box:[-105.301758 39.964069 -105.178505 40.09455]` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `is:retweet` | 他の条件との併用が必須 | 指定されたルールの他の条件に一致するリツイートにマッチします。このオペレーターは、通常のリツイート (たとえば、リツイートボタンを使って生成されたもの) のみを対象とします。引用ツイートはこのオペレーターではマッチしません。
例: `data @XDevelopers -is:retweet` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `is:reply` | 他の条件との併用が必須 | ルールに一致する明示的な返信のみを配信します。また、否定形で使用することで、クエリに一致する返信を配信対象から除外できます。
注: このオペレーターは filtered stream エンドポイントでも利用できます。filtered stream で使用した場合、このオペレーターは元のポストへの返信、引用ツイート内の返信、およびリツイートへの返信に一致します。
例: `from:XDevelopers is:reply` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `is:quote` | 他の条件との併用が必須 | すべての引用ツイート (コメント付きの投稿) を返します。
例: `"sentiment analysis" is:quote` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `is:verified` | 他の条件との併用が必須 | 投稿者がXによって認証済みである投稿のみを返します。
例: `#nowplaying is:verified` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `-is:nullcast` | 他の条件との併用が必須 | ads.twitter.com 上でプロモーション専用として作成され、`"source":"Twitter for Advertisers (legacy)"` または `"source":"Twitter for Advertisers"` という値を持つ投稿を除外します。
この演算子は必ず否定形 (`-is:nullcast`) で指定する必要があります。
Nullcast された投稿の詳細については、[投稿の可用性](https://developer.x.com/content/developer-twitter/en/docs/twitter-api/v1/tweets/post-and-engage/guides/tweet-availability)のページを参照してください。
例: `"mobile games" -is:nullcast` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `has:hashtags` | 他の条件との併用が必須 | 少なくとも 1 つのハッシュタグを含む投稿に一致します。
例: `from:XDevelopers -has:hashtags` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `has:cashtags` | 他の条件との併用が必須 | 先頭に「$」文字が付くキャッシュタグ (例: `$tag`) を含む投稿に一致します。
例: `#stonks has:cashtags\` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `has:links` | 他の条件との併用が必須 | このオペレーターは、本文にリンクまたはメディアを含む投稿にマッチします。
例: `from:XDevelopers announcement has:links` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `has:mentions` | 他の条件との併用が必須 | 他のXユーザーをメンションしている投稿にマッチします。
例: `#nowplaying has:mentions` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `has:media` | 他の条件との併用が必須 | *利用可能な別名：* `has:media_link`
X が写真、GIF、動画などのメディアオブジェクトを含むと判定した投稿にマッチします。Periscope で作成されたメディアや、他のメディアホスティングサイトへのリンクを含む投稿にはマッチしません。
例: `(kittens OR puppies) has:media` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `has:images` | 他の条件との併用が必須 | 画像への URL として認識される URL を含む投稿にマッチします。
例: `#meme has:images` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `has:video_link` | 他の条件との併用が必須 | *利用可能な別名:* `has:videos`
X に直接アップロードされたネイティブの X 動画を含む投稿に一致します。Periscope で作成された動画や、他の動画ホスティングサイトへのリンクを含む投稿には一致しません。
例: `#icebucketchallenge has:video_link` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `has:geo` | 他の条件との併用が必須 | X ユーザーが提供した、投稿固有のジオロケーションデータを持つ投稿にマッチします。これは、対応する表示名、ジオポリゴン、その他のフィールドを含む X place としての位置情報、または、まれなケースとしてジオの緯度・経度座標のいずれかです。
注: place (投稿のジオ情報) でマッチングを行うオペレーターは、オリジナルの投稿のみを対象とします。リツイートには place データは含まれません。
例: `recommend #paris has:geo -bakery` | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `lang:` | 他の条件との併用が必須 | X によって特定の言語であると分類された投稿 (そのポストに対して分類が行われている場合に限る) にマッチします。重要な点として、各ポストは現在 1 つの言語にのみ分類されるため、複数の言語を AND 演算子で組み合わせても結果は返されません。
`lang:` 演算子ごとに指定できる BCP 47 言語識別子は 1 つだけです。
注: 言語分類が行えない場合、返される値は「und」 (undefined を意味) です。
例: `recommend #paris lang:en`
以下の一覧は、現在サポートされている言語と、それぞれに対応する BCP 47 言語識別子です。
アムハラ語: `am` | ドイツ語: `de` | マラヤーラム語: `ml` | スロバキア語: `sk`
アラビア語: `ar` | ギリシャ語: `el` | ディベヒ語 (モルディブ語) : `dv` | スロベニア語: `sl`
アルメニア語: `hy` | グジャラート語: `gu` | マラーティー語: `mr` | ソラニー・クルド語: `ckb`
バスク語: `eu` | ハイチ・クレオール語: `ht` | ネパール語: `ne` | スペイン語: `es`
ベンガル語: `bn` | ヘブライ語: `iw` | ノルウェー語: `no` | スウェーデン語: `sv`
ボスニア語: `bs` | ヒンディー語: `hi` | オリヤー語: `or` | タガログ語: `tl`
ブルガリア語: `bg` | ラテン文字表記ヒンディー語: `hi-Latn` | パンジャーブ語: `pa` | タミル語: `ta`
ビルマ語: `my` | ハンガリー語: `hu` | パシュトー語: `ps` | テルグ語: `te`
クロアチア語: `hr` | アイスランド語: `is` | ペルシア語: `fa` | タイ語: `th`
カタロニア語: `ca` | インドネシア語: `in` | ポーランド語: `pl` | チベット語: `bo`
チェコ語: `cs` | イタリア語: `it` | ポルトガル語: `pt` | 繁体字中国語: `zh-TW`
デンマーク語: `da` | 日本語: `ja` | ルーマニア語: `ro` | トルコ語: `tr`
オランダ語: `nl` | カンナダ語: `kn` | ロシア語: `ru` | ウクライナ語: `uk`
英語: `en` | クメール語: `km` | セルビア語: `sr` | ウルドゥー語: `ur`
エストニア語: `et` | 韓国語: `ko` | 簡体字中国語: `zh-CN` | ウイグル語: `ug`
フィンランド語: `fi` | ラオ語: `lo` | シンド語: `sd` | ベトナム語: `vi`
フランス語: `fr` | ラトビア語: `lv` | シンハラ語: `si` | ウェールズ語: `cy`
グルジア語 (ジョージア語) : `ka` | リトアニア語: `lt` |