オペレーター一覧
注: 一部のオペレーターには別名（エイリアス）が用意されています。
| 運用者 | タイプ | 概要 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
keyword | 単体 | Post の本文内のキーワードに一致します。これはトークン化によるマッチであり、指定したキーワード文字列は Post 本文のトークン化済みテキストと照合されます。トークン化では、句読点、記号、Unicode 基本多言語面における区切り文字を基準に語を分割します。 たとえば、テキスト「I like coca-cola」を含むPostは、次のトークンに分割されます：I、like、coca、cola。これらのトークンは、クエリで使用するキーワード文字列と照合されます。句読点（例：coca-cola）、記号、またはセパレーター文字を含む文字列に一致させるには、キーワードを二重引用符で囲む必要があります。 例： pepsi OR cola OR "coca cola" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
絵文字 | 単体 | Post の本文に含まれる絵文字に一致します。キーワードと同様に、絵文字はトークン化による一致であり、指定した絵文字は Post 本文のトークン化されたテキストと照合されます。 絵文字にバリアントがある場合は、クエリに追加する際に二重引用符で囲む必要があります。 例： (😃 OR 😡) 😬 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
"フレーズの完全一致" | 単体 | Post の本文内で、フレーズが完全一致するものに一致します。 例： ("X API" OR #v2) -"recent search" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
# | 単体 | ハッシュタグがPost内で認識済みのエンティティである場合、認識済みのハッシュタグを含む任意のPostに一致します。 このオペレーターはトークン化による一致ではなく、完全一致を行います。つまり、このルール #thankuは、ハッシュタグ #thanku を正確に含む投稿には一致しますが、ハッシュタグ #thankunext を含む投稿には一致しません。例： #thankunext #fanart OR @arianagrande | ||||||||||||||||||||||||||||||||||||||||||||||||||||
@ | 単体 | 指定したユーザー名が認識されたエンティティである場合（@文字を含む）、そのユーザー名への言及を含む任意のPostに一致します。 例： (@XDevelopers OR @API) -@X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
$ | 単体 | 指定された内容を含む任意のPostにマッチします’キャッシュタグ（Cashtag）‘（トークンの先頭文字が である場合）<br /><br />なお、cashtag オペレーターは X の「symbols」エンティティ抽出に依存して cashtag を識別します。本文から直接 cashtag を抽出することはありません。's'記号'本文から直接cashtagを抽出しようとするのではなく、cashtagに一致させるためにエンティティ抽出を使用します。<br /><br />例：`twtr OR @XDevelopers -$fb` | ||||||||||||||||||||||||||||||||||||||||||||||||||||
from: | 単体 | 特定のユーザーのPostすべてに一致します。 値には、ユーザー名（@ は含めない）またはユーザーの数値ユーザーIDのいずれかを指定できます。 1 つのユーザー名または id しか渡せません from:オペレータ。例： from:XDevelopers OR from:API -from:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
宛先: | 単体 | 特定のユーザーへの返信である任意のPostにマッチします。 値は、ユーザー名（@ を除く）またはユーザーの数値のユーザーIDのいずれかです。 1 つのユーザー名または id しか渡せません 宛先:演算子。例： to:XDevelopers OR to:API -to:X | ||||||||||||||||||||||||||||||||||||||||||||||||||||
url: | 単体 | 有効な形式のPostのURLに対して、トークン化マッチを実行します。 この演算子は、 url フィールドと expanded_url フィールドの両方の内容にマッチしますurlまたはexpanded_urlfields。たとえば、Post を含む”X Developer Labs をぜひご覧ください：https://t.co/c0A36SWil4”（短縮URLがリダイレクトされてhttps://developer.twitter.com) は、次の2つのルールの両方に一致します：from:XDevelopers url:"https://developer.twitter.com"（その内容と一致するためentities.urls.expanded_url)from:XDevelopers url:"https://t.co"（entities.urls.expanded_url の内容と一致するため）entities.urls.url)句読点や特殊文字を含むトークンやフレーズは、二重引用符で囲んでください（例： url:"/developer")。同様に、特定のプロトコルに一致させるには、二重引用符で囲みます（例：url:"https://developer.twitter.com")。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
retweets_of: | 単体 | 指定したユーザーのRetweetであるPostに一致します。値には、ユーザー名（@を除く）またはユーザーの数値のユーザーIDのいずれかを指定できます。retweets_of: オペレーターごとに指定できるユーザー名／id は1つのみですretweets_of:演算子。例： retweets_of:twitterdev OR retweets_of:twitterapi | ||||||||||||||||||||||||||||||||||||||||||||||||||||
in_reply_to_tweet_id: | 単体 | 利用可能なエイリアス: in_reply_to_status_id:指定されたPostへの返信に一致します。 例： in_reply_to_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
retweets_of_tweet_id: | 単体 | 使用可能なエイリアス： retweets_of_status_id:指定したPostの明示的（またはネイティブ）Retweetにマッチします。使用するPostのIDは、Retweetではなく元のPostのIDである点にご注意ください。 例： retweets_of_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
quotes_of_tweet_id: | 単体 | 利用可能な別名: quotes_of_status_id:指定したPostの引用Tweetにマッチします。使用するPostのidは、引用Tweetではなく元のPostのidである必要がある点に注意してください。 例： quotes_of_tweet_id:1539382664746020864 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
context: | 単体 | 特定のドメイン id とエンティティ id の組み合わせに一致する Post を取得します。 このオペレーターの詳細は、こちらのページをご覧ください注釈.context: オペレーターごとに指定できるドメイン／エンティティは1つだけですcontext:オペレータ。context:domain_id.entity_idただし、OR 演算子を使って複数のドメインやエンティティを組み合わせることもできます： (context:47.1139229372198469633 OR context:11.1088514520308342784)例： context:10.799022225751871488(domain_id.entity_idその特定のドメインとエンティティの組み合わせに一致するPostを返します) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
entity: | 単体 | 特定のエンティティの文字列値に一致するPostを照合します。 この演算子の詳細は、次のページをご覧ください注釈. ご注意これは最近の検索でのみ利用可能であることにご注意ください。 1 つだけ渡せます entity:オペレータ。entity:"エンティティ／場所の文字列表現"例： entity:"Michael Jordan" OR entity:"Barcelona" | ||||||||||||||||||||||||||||||||||||||||||||||||||||
conversation_id: | 単体 | 共通の会話IDを持つPostに一致します。会話IDは、会話を開始したPostのPost IDに設定されます。Postへの返信が投稿されると、返信への返信であっても、conversation_idそのJSONペイロードに追加されます。conversation_id: オペレーターごとに指定できる会話IDは1つだけですconversation_id:オペレーター。例： conversation_id:1334987486343299072 (from:XDevelopers OR from:api) | ||||||||||||||||||||||||||||||||||||||||||||||||||||
list: | 単体 | 指定したリストのメンバーであるユーザーが投稿したPostにマッチします。 たとえば、@XDevelopers と @api がリスト123のメンバーで、あなたが list:123クエリに list:123 を含めると、レスポンスにはそれらのアカウントが公開した Post のみが返されます。List ID はリストの検索エンドポイント。ご留意ください1 つしか使用できません list:クエリごとに演算子は 1 つだけ使用でき、さらにlist:演算子。例： list:123 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
place: | 単体 | 指定した場所またはXのplace IDでタグ付けされたPostに一致します。複数語の地名（“New York City”、“Palo Alto”）は引用符で囲んでください。place: 演算子につき、指定できる場所は1つだけですplace:オペレーター。注: 次を参照GET geo/searchX の place ID を取得するには、standard v1.1 のエンドポイント GET geo/search を参照してください。 Note: このオペレーターはリツイートには一致しません。リツイートは’場所は元のPostに紐づいたものに限られます。Quote Tweetの元のPostに紐づいた場所にもマッチしません。 例： place:"new york city" OR place:seattle OR place:fd70c22040963ac7 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
place_country: | 単体 | タグ付けされた場所／ロケーションに紐づく国コードが、指定した ISO アルファ2文字コードと一致する Post を一致対象とします。 有効な ISO コードの一覧は以下をご覧くださいWikipedia。 place_country: 演算子ごとに渡せる ISO コードは 1 つだけですplace_country:オペレータ。注: このオペレーターはリポストには一致しません。リポスト’の場所情報は元のPostに紐づけられます。引用Tweetの元のPostに紐づいた場所情報にも一致しません。 例： place_country:US OR place_country:MX OR place_country:CA | ||||||||||||||||||||||||||||||||||||||||||||||||||||
point_radius: | 単体 | 〜と照合しますplace.geo.coordinatesPost が存在する場合はその place.geo.coordinates オブジェクトに対して、また X では、定義された領域内に完全に収まる Place のジオポリゴンに対して一致します。point_radius:[longitude latitude radius]- 対応する半径の単位は、マイル（mi）とキロメートル（km）です - 半径は25マイル未満である必要があります - 経度は±180の範囲内です - 緯度は±90の範囲内です - すべての座標は小数の度数（十進法）で表記されています - ルールの引数は角括弧内に置き、スペースで区切ります point_radius: 演算子ごとに渡せるジオポリゴンは 1 つだけですpoint_radius:オペレータ。Note: このオペレーターはリツイートには一致しません。リツイートは’場所は元のPostに添付されたものには一致しません。Quote Tweetの元のPostに添付された場所にも一致しません。 例： point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] | ||||||||||||||||||||||||||||||||||||||||||||||||||||
bounding_box: | 単体 | 利用可能な別名: geo_bounding_box:（存在する場合は）Post の place.geo.coordinates オブジェクト、ならびに X では場所のジオポリゴンに対して照合します。ここで、場所のポリゴンが定義された領域内に完全に含まれていることが条件です。 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 の範囲内 - すべての座標は小数表記（度）です。 - ルールの引数は角括弧で囲み、スペースで区切ります。 bounding_box: オペレーターごとに指定できる地理ポリゴンは1つのみですbounding_box:オペレータ。Note: このオペレーターはRetweetには一致しません。Retweetは’s の場所情報は元のPostに付与されています。Quote Tweetの元のPostに付与された場所情報にも一致しません。 例： bounding_box:[-105.301758 39.964069 -105.178505 40.09455] | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_likes | 単体 | 少なくとも指定した数の「いいね」があるPostに一致します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_replies | 単体 | 少なくとも指定した数の返信があるPostに一致します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
min_reposts | 単体 | 少なくとも指定した回数リポストされたPostに一致します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:retweet | 接続詞が必要です | 指定されたルールの他の条件にも一致するRetweetにマッチします。このオペレーターは、いわゆる「本来のRetweet」（例：Retweetボタンで生成されたもの）のみを検出します。Quote Tweetにはマッチしません。 例： data @XDevelopers -is:retweet | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:reply | 接続詞が必要です | ルールに一致する明示的な返信のみを配信します。否定を用いて、クエリに一致する返信を配信対象から除外することもできます。 Note: このオペレーターは filtered stream エンドポイントでも利用できます。filtered stream と併用する場合、このオペレーターは元の Post への返信、引用した Tweet 内での返信、Retweet 内での返信に一致します。 例： from:XDevelopers is:reply | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:quote | 接続詞が必要です | コメント付きのPost（Quote Tweet）をすべて返します。 例： "感情分析" is:quote | ||||||||||||||||||||||||||||||||||||||||||||||||||||
is:verified | 接続詞が必要です | X によって認証済みの投稿者が作成した Post のみを配信します。 例： #nowplaying is:verified | ||||||||||||||||||||||||||||||||||||||||||||||||||||
-is:nullcast | 接続詞が必要です | ads.twitter.com でプロモーション専用として作成された、次のいずれかを持つ Post を除外します"source":"Twitter for Advertisers（従来版）"または"source":"Twitter for Advertisers"。このオペレーターは否定して使用する必要があります。 Nullcast された Post の詳細については、こちらのページをご覧くださいPost の可用性. 例： "mobile games" -is:nullcast | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:hashtags | 接続詞が必要です | 少なくとも1つのハッシュタグを含むPostにマッチします。 例： from:XDevelopers -has:hashtags | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:cashtags | 接続詞が必要です | 先頭が「tag)。<br /><br />例：#stonks has:cashtags` | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:links | 接続詞が必要です | このオペレーターは、Post 本文にリンクとメディアが含まれる Post にマッチします。 例： from:XDevelopers announcement has:links | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:mentions | 接続詞が必要です | 別のXユーザーへの言及を含むPostに一致します。 例： #nowplaying has:mentions | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:media | 接続詞が必要です | 利用可能なエイリアス： has:media_linkX により判定された、写真、GIF、動画などのメディアオブジェクトを含む Post に一致します。Periscope で作成されたメディアや、他のメディアホスティングサイトへのリンクを含む Post には一致しません。 例： (kittens OR puppies) has:media | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:images | 接続詞が必要です | 画像への認識済みURLを含むPostにマッチします。 例： #meme has:images | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:video_link | 接続詞が必要です | 利用可能な別名： has:videosX に直接アップロードされたネイティブ動画を含む Post に一致します。Periscope で作成された動画や、他の動画ホスティングサイトへのリンクを含む Post には一致しません。 例： #icebucketchallenge has:video_link | ||||||||||||||||||||||||||||||||||||||||||||||||||||
has:geo | 接続詞が必要です | Xユーザーが提供した、Post固有のジオロケーションデータを持つPostに一致します。これは、対応する表示名、ジオポリゴン、その他のfieldsを備えたXのプレイスとしての位置情報、または、まれに緯度・経度の座標である場合があります。 注意: 場所（Post の地理情報）に一致するオペレーターは、元の Post からの一致のみが対象です。Retweet には場所データは含まれません。 例： recommend #paris has:geo -bakery | ||||||||||||||||||||||||||||||||||||||||||||||||||||
lang: | 接続詞が必要です | X によって特定の言語と分類された Post（Post が分類されている場合に限る）に一致します。各 Post は現時点では 1 つの言語にのみ分類されるため、複数の言語を AND 条件で指定しても結果は得られない点に留意してください。‘複数の言語を組み合わせて検索しても、結果は返されません。 BCP 47 の言語識別子は 1 つしか渡せません lang:オペレータ。注記: 言語を判定できない場合、返される結果は「und」（未定義）になります。 例： recommend #paris lang:en以下の一覧は、現在サポートされている言語とそれぞれの BCP 47 言語識別子を示します。 アムハラ語: am | ドイツ語：de | マラヤーラム語：ml | スロバキア語：skアラビア語： ar | ギリシャ語：el | モルディブ語:dv | スロベニア語：slアルメニア語: hy | グジャラート語：gu | マラーティー語：mr | ソラニ・クルド語:ckbバスク語： eu | ハイチ・クレオール語：ht | ネパール語:ne | スペイン語：esベンガル語： bn | ヘブライ語：he | ノルウェー語:いいえ | スウェーデン語：svボスニア語： bs | ヒンディー語：hi | オリヤー語：または | タガログ: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英語： 英語 | クメール語：km | セルビア語：sr | ウルドゥー語：urエストニア語： et | 韓国語：ko | 簡体中国語:zh-CN | ウイグル語：ウイグル語: ugフィンランド語： fi | ラオ語：lo | シンド語：sd | ベトナム語：viフランス語： fr | ラトビア語：lv | シンハラ語:si | ウェールズ語：cyグルジア語: ka | リトアニア語：lt |