keyword | Independente | Core | Corresponde a uma palavra-chave no corpo de um Post. Esta é uma correspondência tokenizada, o que significa que sua string de palavra-chave será comparada ao texto tokenizado do corpo do Post. A tokenização divide palavras com base em pontuação, símbolos e caracteres separadores do plano básico Unicode. Por exemplo, um Post com o texto “I like coca-cola” seria dividido nos seguintes tokens: I, like, coca, cola. Esses tokens seriam então comparados à string de palavra-chave usada em sua query. Para corresponder a strings contendo pontuação (por exemplo coca-cola), símbolos ou caracteres separadores, você deve envolver sua palavra-chave em aspas duplas. Exemplo: pepsi OR cola OR "coca cola" |
emoji | Independente | Core | Corresponde a um emoji no corpo de um Post. Semelhante a uma palavra-chave, emojis são uma correspondência tokenizada, o que significa que seu emoji será comparado ao texto tokenizado do corpo do Post. Note que se um emoji tem uma variante, você deve envolvê-lo em aspas duplas para adicioná-lo a uma query. Exemplo: (😃 OR 😡) 😬 |
"exact phrase match" | Independente | Core | Corresponde à frase exata no corpo de um Post. Exemplo: ("X API" OR #v2) -"recent counts" |
# | Independente | Core | Corresponde a qualquer Post contendo uma hashtag reconhecida, se a hashtag for uma entidade reconhecida em um Post. Este operador executa uma correspondência exata, NÃO uma correspondência tokenizada, o que significa que a regra #thanku corresponderá a posts com a hashtag exata #thanku, mas não àqueles com a hashtag #thankunext. Exemplo: #thankunext #fanart OR @arianagrande |
@ | Independente | Core | Corresponde a qualquer Post que menciona o nome de usuário fornecido, se o nome de usuário for uma entidade reconhecida (incluindo o caractere @). Exemplo: (@XDevelopers OR @API) -@X |
$ | Independente | Advanced | Corresponde a qualquer Post que contém o ‘cashtag’ especificado (onde o caractere inicial do token é o caractere ‘'). Note que o operador cashtag depende da extração de entidade 'symbols' do X para corresponder a cashtags, em vez de tentar extrair o cashtag do próprio corpo. Exemplo: `twtr OR @XDevelopers -$fb` |
from: | Independente | Core | Corresponde a qualquer Post de um usuário específico. O valor pode ser o nome de usuário (excluindo o caractere @) ou o ID numérico do usuário. Você só pode passar um único nome de usuário/ID por operador from: . Exemplo: from:XDevelopers OR from:API -from:X |
to: | Independente | Core | Corresponde a qualquer Post que é uma resposta a um usuário específico. O valor pode ser o nome de usuário (excluindo o caractere @) ou o ID numérico do usuário. Você só pode passar um único nome de usuário/ID por operador to: . Exemplo: to:XDevelopers OR to:API -to:X |
url: | Independente | Core | Executa uma correspondência tokenizada em qualquer URL validamente formatada de um Post. Este operador pode corresponder ao conteúdo dos campos url ou expanded_url . Por exemplo, um Post contendo “You should check out X Developer Labs: https://t.co/c0A36SWil4” (com a URL curta redirecionando para https://developer.x.com) corresponderá a ambas as seguintes regras: from:XDevelopers url:"https://developer.x.com" e from:XDevelopers url:"https://t.co" . Tokens e frases contendo pontuação ou caracteres especiais devem estar entre aspas duplas. |
retweets_of: | Independente | Core | Corresponde a Posts que são Retweets do usuário especificado. O valor pode ser o nome de usuário (excluindo o caractere @) ou o ID numérico do usuário. Você só pode passar um único nome de usuário/ID por operador retweets_of: . Exemplo: retweets_of:XDevelopers OR retweets_of:API |
context: | Independente | Core | Corresponde a Posts com um par específico de domain id/entity id. Você só pode passar um único domain/entity por operador context: . Exemplo: context:domain_id.entity_id . Você pode combinar múltiplos domain/entities usando o operador OR: (context:47.113922 9372198469633 OR context:11.1088514520308342784) |
entity: | Independente | Core | Corresponde a Posts com um valor de string de entidade específico. Você só pode passar um único operador entity: . Exemplo: entity:"string declaration of entity/place" . Por favor, note que isso está disponível apenas com busca recente. |
conversation_id: | Independente | Core | Corresponde a Posts que compartilham um conversation_id comum. Um conversation_id é definido como o ID do Post de um Post que iniciou uma conversa. Conforme respostas a um Post são publicadas, mesmo respostas a respostas, o conversation_id é adicionado ao seu payload JSON. Você só pode passar um único conversation ID por operador conversation_id: . Exemplo: conversation_id:1334987486343299072 (from:XDevelopers OR from:API) |
list: | Independente | Advanced | Corresponde a Posts publicados por usuários que são membros de uma List especificada. Por exemplo, se @XDevelopers e @API fossem membros da List 123, e você incluísse list:123 em sua query, sua resposta conterá apenas Posts que foram publicados por essas contas. Você pode encontrar IDs de List usando o endpoint de consulta de List. Exemplo: list:123 |
place: | Independente | Advanced | Corresponde a Posts marcados com a localização especificada ou ID de lugar do X. Nomes de lugares com múltiplas palavras (“New York City”, “Palo Alto”) devem estar entre aspas. Você só pode passar um único lugar por operador place: . Nota: Veja o endpoint GET geo/search Standard v1.1 para como obter IDs de lugar do X. Exemplo: place:"new york city" OR place:seattle OR place:fd70c22040963ac7 |
place_country: | Independente | Advanced | Corresponde a Posts onde o código do país associado a um lugar/localização marcado corresponde ao código de caractere alfa-2 ISO fornecido. Você pode encontrar uma lista de códigos ISO válidos na Wikipedia. Você só pode passar um único código ISO por operador place_country: . Exemplo: place_country:US OR place_country:MX OR place_country:CA |
point_radius: | Independente | Advanced | Corresponde ao objeto place.geo.coordinates do Post quando presente, e no X, a um polígono geo de lugar, onde o polígono do lugar está totalmente contido dentro da região definida. point_radius:[longitude latitude radius] . Unidades de raio suportadas são milhas (mi) e quilômetros (km). O raio deve ser menor que 25mi. Longitude está na faixa de ±180. Latitude está na faixa de ±90. Todas as coordenadas estão em graus decimais. Argumentos da regra estão contidos dentro de colchetes, delimitados por espaço. Exemplo: point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi] |
bounding_box: | Independente | Advanced | Corresponde ao objeto place.geo.coordinates do Post quando presente, e no X, a um polígono geo de lugar, onde o polígono do lugar está totalmente contido dentro da região definida. bounding_box:[west_long south_lat east_long north_lat] . Largura e altura da caixa delimitadora devem ser menores que 25mi. Longitude está na faixa de ±180. Latitude está na faixa de ±90. Todas as coordenadas estão em graus decimais. Argumentos da regra estão contidos dentro de colchetes, delimitados por espaço. Exemplo: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] |
is:retweet | Conjunção obrigatória | Core | Corresponde a Retweets que correspondem ao resto da regra especificada. Este operador procura apenas por Retweets verdadeiros (por exemplo, aqueles gerados usando o botão Retweet). Quote Tweets não serão correspondidos por este operador. Exemplo: data @XDevelopers -is:retweet |
is:reply | Conjunção obrigatória | Core | Entrega apenas respostas explícitas que correspondem a uma regra. Também pode ser negado para excluir respostas que correspondem a uma query da entrega. Nota: Este operador também está disponível com o endpoint de stream filtrado. Quando usado com stream filtrado, este operador corresponde a respostas a um Post original, respostas em Posts citados e respostas em Retweets. Exemplo: from:XDevelopers is:reply |
is:quote | Conjunção obrigatória | Core | Retorna todos os Quote Tweets, também conhecidos como Posts com comentários. Exemplo: "sentiment analysis" is:quote |
is:verified | Conjunction required | Core | Entrega apenas Posts cujos autores são verificados pelo X. Exemplo: #nowplaying is:verified |
-is :nullcast | Conjunction required | Advanced | Remove Posts criados apenas para promoção no ads.x.com que possuem "source":"Twitter for Advertisers (legacy)" ou "source":"Twitter for Advertisers" . Este operador deve ser negado. Para mais informações sobre Posts Nullcasted, consulte nossa página sobre disponibilidade de Posts. Exemplo: "mobile games" -is:nullcast |
has:hashtags | Conjunction required | Core | Encontra Posts que contêm pelo menos uma hashtag. Exemplo: from:XDevelopers -has:hashtags |
has:cashtags | Conjunction required | Advanced | Encontra Posts que contêm um símbolo de cashtag (com um caractere ‘' inicial. Por exemplo, `tag). Exemplo: #stonks has:cashtags` |
has:links | Conjunction required | Core | Este operador encontra Posts que contêm links e mídia no corpo do Post. Exemplo: from:XDevelopers announcement has:links |
has:mentions | Conjunction required | Core | Encontra Posts que mencionam outro usuário do X. Exemplo: #nowplaying has:mentions |
has:media | Conjunction required | Core | Encontra Posts que contêm um objeto de mídia, como uma foto, GIF ou vídeo, conforme determinado pelo X. Isso não encontrará mídia criada com Periscope, ou Posts com links para outros sites de hospedagem de mídia. Exemplo: (kittens OR puppies) has:media |
has:images | Conjunction required | Core | Encontra Posts que contêm uma URL reconhecida para uma imagem. Exemplo: #meme has:images |
has:videos | Conjunction required | Core | Encontra Posts que contêm vídeos nativos do X, enviados diretamente para o X. Isso não encontrará vídeos criados com Periscope, ou Posts com links para outros sites de hospedagem de vídeo. Exemplo: #icebucketchallenge has:videos |
has:geo | Conjunction required | Advanced | Encontra Posts que possuem dados de geolocalização específicos do Post fornecidos pelo usuário do X. Isso pode ser uma localização na forma de um local do X, com o nome de exibição correspondente, polígono geográfico e outros campos, ou em casos raros, uma coordenada geográfica lat-long. Nota: Operadores que fazem busca por local (geo do Post) incluirão apenas resultados de posts originais. Retweets não contêm dados de local. Exemplo: recommend #paris has:geo -bakery |
lang: | Conjunction required | Core | Encontra Posts que foram classificados pelo X como sendo de um idioma específico (se, e somente se, o Post foi classificado). É importante notar que cada Post atualmente é classificado como sendo de apenas um idioma, então usar AND com múltiplos idiomas não produzirá resultados. Você pode passar apenas um único identificador de idioma BCP 47 por operador lang: . Nota: se nenhuma classificação de idioma puder ser feita, o resultado fornecido é ‘und’ (para indefinido). Exemplo: recommend #paris lang:en |