Regras e filtros: Enterprise

​

Introdução às regras e consultas Enterprise

Os produtos que utilizam operadores Enterprise fornecem dados sociais com base nas regras de filtragem que você configura. As regras são formadas por uma ou mais “cláusulas”, em que uma cláusula pode ser uma palavra‑chave, uma frase exata ou um dos vários operadores Enterprise. Antes de começar a criar regras com operadores Enterprise, revise a sintaxe descrita abaixo, consulte a lista de operadores disponíveis e entenda as restrições para a criação de regras. Você também deve compreender as nuances de como as regras são avaliadas logicamente, na seção “Ordem de operações”.

Várias cláusulas podem ser combinadas com lógica “and” e “or”.

Atenção: a lógica “and” é especificada com um espaço entre as cláusulas, enquanto a lógica “or” é especificada com OR em maiúsculas.

Cada regra pode ter até 2.048 caracteres, sem limites quanto ao número de cláusulas positivas (itens que você deseja corresponder ou filtrar) e cláusulas negativas (itens que você deseja excluir e não corresponder).  

​

Criação de regras e consultas 

Correspondência por palavra‑chave

As correspondências por palavra‑chave são semelhantes às consultas em uma interface de pesquisa. Por exemplo, a seguinte regra de operador Enterprise corresponderia a atividades com o termo “social” no corpo do texto.

social

Aplicando AND entre termos com espaço

Adicionar outra palavra‑chave equivale a adicionar outro requisito para encontrar correspondências. Por exemplo, esta regra corresponderia apenas a atividades em que tanto “social” quanto “media” estivessem presentes no texto, em qualquer ordem — ter um espaço entre os termos funciona como lógica booleana AND. Se você incluir um AND explícito na sua regra, ele será rejeitado pelo endpoint de regras.

social media

Aplicando OR entre termos com OR em maiúsculas

Muitas situações pedem lógica booleana OR. Isso também é fácil de fazer. Observe que o operador OR deve estar em maiúsculas; um ‘or’ em minúsculas será tratado como uma palavra‑chave comum.

social OR data

Negando termos

Outros cenários podem exigir a exclusão de resultados com certas palavras‑chave (lógica booleana NOT). Por exemplo, atividades com ‘happy’, mas excluindo quaisquer com ‘birthday’ no texto.

social -personality

Agrupamento com parênteses

Essas lógicas podem ser combinadas por meio de agrupamento com parênteses e expandidas para consultas muito mais complexas.

(social OR data) (academic OR research) -personality -information -university

Isso é só o começo — enquanto os exemplos acima se baseiam simplesmente em correspondência tokenizada para palavras‑chave, os produtos Enterprise também oferecem operadores para realizar diferentes tipos de correspondência no texto.

Correspondência exata

"social media research"

Correspondência por substring

contains:info

Correspondência por proximidade

"social media research"~3

Além disso, outros operadores permitem filtrar por aspectos exclusivos dos dados sociais, além do texto. 

O usuário que está publicando um Post

from:XDevelopers

Tweets com geotag em um raio de 10 milhas da Pearl St., em Boulder, CO, Estados Unidos

point_radius:[-105.27346517 40.01924738 10.0mi]

Juntando tudo

Eles podem ser combinados com filtros de texto usando os mesmos tipos de lógica descritos acima.

(social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university

​

Sintaxe booleana

Os exemplos na seção anterior utilizaram vários tipos de lógica booleana e agrupamento. Veja a tabela abaixo para obter mais detalhes sobre a sintaxe e os requisitos de cada um.

Tipo de lógica	Sintaxe do operador	Descrição
AND	social data	Espaço em branco entre dois operadores resulta em lógica AND entre eles Corresponde a atividades que contenham ambas as palavras‑chave (“social”, “data”). Não use AND explicitamente na sua regra. Use apenas espaço em branco. Um AND explícito será tratado como uma palavra‑chave comum.
OR	social OR data	Para aplicar OR entre dois operadores, insira OR em letras maiúsculas, separado por espaços em branco entre eles Corresponde a atividades com UMA OU OUTRA palavra‑chave (“social” OR “data”) Observe que, se você combinar funcionalidades OR e AND em uma única regra, deve compreender a ordem de operações descrita na nossa seção “Order of operations” e considerar agrupar operadores não negados usando parênteses, conforme descrito abaixo, para garantir que sua regra se comporte conforme o esperado. Você deve usar “OR” em maiúsculas na sua regra. “or” em minúsculas será tratado como uma palavra‑chave comum.
NOT	social data -apple -android -phone	Insira um caractere - imediatamente antes do operador ou do grupo de operadores. A regra do exemplo corresponde a atividades que contêm a palavra‑chave “social”, mas exclui aquelas que contêm a palavra‑chave “data”. ORs negados não são permitidos quando a regra solicitaria “tudo no firehose exceto a negação”. Por exemplo, apple OR -ipad é inválido porque corresponderia a todas as atividades, exceto as que mencionam “ipad”.
Agrupamento	(social OR data) -XDevelopers -api	Parênteses ao redor de vários operadores criam um “grupo” funcional. Grupos podem ser conectados a cláusulas da mesma maneira que uma cláusula individual, via espaço em branco (AND) ou ORs. No entanto, é prática recomendada não agrupar negações aplicando o sinal de negação - ao grupo inteiro. Em vez disso, negue cada operador individualmente, encadeando‑os via espaço em branco (AND).  Por exemplo, em vez de usar -(iphone OR imac OR macbook), use: -iphone -imac -macbook O agrupamento é especialmente importante quando uma única regra combina funcionalidades AND e OR, devido à ordem de operações usada para avaliar a regra. Veja abaixo para mais detalhes.

Observação: os operadores podem ser positivos ou negativos.

Operadores positivos definem o que você deseja incluir nos resultados. Por exemplo, o operador has:hashtags diz “Quero atividades que contenham hashtags.”

Operadores negativos definem o que você deseja excluir dos resultados e são criados usando a lógica booleana NOT descrita acima. Por exemplo, -has:hashtags diz “Exclua quaisquer atividades que contenham hashtags, mesmo que elas correspondam à minha regra de outra forma.”

Os produtos de operadores Premium não têm restrição quanto ao número de cláusulas positivas e negativas, sujeitas a um comprimento máximo de 2.048 caracteres.  

​

Ordem de execução

Ao combinar as funcionalidades AND e OR em uma única regra, a seguinte ordem de execução determinará como sua regra será avaliada.

1. Operadores conectados pela lógica AND são combinados primeiro
2. Em seguida, operadores conectados pela lógica OR são aplicados

Exemplo:

• apple OR iphone ipad seria avaliado como apple OR (iphone ipad)
• ipad iphone OR android seria avaliado como (iphone ipad) OR android

Para eliminar ambiguidades e garantir que suas regras sejam avaliadas conforme o esperado, agrupe os termos com parênteses quando apropriado. Por exemplo:

• (apple OR iphone) ipad
• iphone (ipad OR android)

​

Pontuação, diacríticos e diferenciação de maiúsculas e minúsculas

Se você especificar uma regra de palavra-chave ou hashtag com acentos ou diacríticos para operadores Enterprise, ela corresponderá ao texto do Post respeitando os diacríticos (hashtags ou palavras‑chave). Uma regra com a palavra‑chave Diacr**í**tica ou a hashtag #cumplea**ñ**os corresponderá a “Diacrítica” ou “#cumpleaños”, mas não a “Diacritica” ou “#cumpleanos”, sem o til (í) ou o (eñe).

Caracteres com acentos ou diacríticos são tratados da mesma forma que caracteres normais e não são considerados limites de palavra. Por exemplo, uma regra de cumpleaños corresponderia apenas a atividades que contêm a palavra cumpleaños e não corresponderia a atividades que contêm cumplea, cumplean ou os.

Todos os operadores são avaliados sem diferenciação de maiúsculas e minúsculas. Por exemplo, a regra Cat corresponderá a todos os seguintes: “cat”, “CAT”, “Cat”.

​

Tags de regras do PowerTrack

Conforme descrito na nossa página “Matching rules”, cada regra pode ser criada com uma tag. Essas tags não têm efeito na filtragem, mas podem ser usadas para criar agrupamentos lógicos de regras dentro da sua App. Cada regra pode ter apenas uma tag, com no máximo 255 caracteres. As tags são incluídas na regra em formato JSON no momento da criação via API, conforme descrito na página “Matching rules”.

​

Colocando regras em formato JSON

Para adicionar ou excluir uma regra de um stream via a API, as regras devem utilizar o formato JSON. Essencialmente, isso requer colocar cada regra na seguinte estrutura:

{"value":"insert_rule_here"}

Regras com aspas duplas

Se a regra contiver caracteres de aspas duplas (") associados a correspondência exata ou outros operadores, eles devem ser escapados usando uma barra invertida para distingui-los da estrutura do JSON.

"social data" @XDevelopers

A regra formatada em JSON ficaria:

{"value":"\"social data\" @XDevelopers"}

Regras com literais de string com aspas duplas

Para incluir um caractere de aspas duplas como literal de string dentro de uma correspondência exata, ele deve ser escapado duas vezes. Por exemplo, para uma regra que corresponda exatamente à frase “Toys “R” Us”, incluindo as aspas ao redor de “R”, a representação em texto simples ficaria assim:

"Toys \"R\" Us"

Convertendo isso para o formato JSON, use a seguinte estrutura:

{"value":"\"Toys \\\"R\\\" Us\""}

Regras com tags

Para incluir uma tag opcional na sua regra, conforme descrito acima, basta incluir um campo adicional tag junto com o valor da regra.

{"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"}

Formatação para solicitações à API

Ao adicionar ou excluir regras do stream via a API, várias regras formatadas em JSON devem ser separadas por vírgulas e agrupadas em um array JSON “rules”, como mostrado abaixo:

{"rules":[{"value":"from:XDevelopers"},{"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"}]}

​

Operadores que correspondem a Quote Tweets

Ao usar a PowerTrack API e a Historical PowerTrack API, os operadores abaixo corresponderão ao conteúdo tanto do Post original que foi citado quanto do novo Quote Tweet.

No entanto, se você estiver usando a Search API, esses operadores corresponderão apenas ao conteúdo do Quote Tweet e não corresponderão a nenhum conteúdo do Post original que foi citado.

• Keywords
• Phrases
• Proximity
• #hashtags
• @mentions
• $cashtags
• url:
• url_contains:
• has:links
• has:mentions
• has:hashtags
• has:media
• has:symbols
• is:quote
• is:reply

​

Operadores do Enterprise

Abaixo estão os operadores disponíveis no PowerTrack e no Historical PowerTrack. Um subconjunto deles está disponível nas APIs de pesquisa de 30 dias e de acervo completo. Consulte esta tabela para uma lista, por produto, dos operadores disponíveis. 

Operador	Descrição
keyword	Encontra uma palavra-chave no corpo do texto ou URL de um Post. Palavras-chave devem começar com um dígito (0-9) ou qualquer caractere que não seja pontuação. A busca por palavras-chave é tokenizada, ou seja, a palavra-chave é comparada com o texto tokenizado do corpo do Post. Para strings com pontuação (ex.: “coca-cola”), use uma “busca de frase exata” entre aspas. Exemplo: (social OR pizza OR wildfire) -planet
emoji	Encontra um emoji no corpo de um Post, usando busca tokenizada baseada em pontuação, símbolo/emoji e caracteres separadores. Se um emoji tem uma variante, use aspas para buscas exatas. Exemplo: (🍕 OR 💜 OR 🐢) -🤖
”busca de frase exata”	Encontra uma frase exata no corpo de um Post. Pontuação é tratada como espaço em branco. Exemplo: ("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth"
#	Encontra qualquer Post com a hashtag especificada. Esta é uma busca exata, ou seja, #2016 encontrará posts com #2016 mas não #2016election. Exemplo: (#social OR #pizza OR #2016election) -#planet
@	Encontra qualquer Post que menciona o nome de usuário especificado. Exemplo: (@XDevelopers OR @api OR @twittereng) -@jack
”keyword1 keyword2”~N	Operador de proximidade que encontra um Post onde palavras-chave estão dentro de N tokens uma da outra. Palavras-chave em ordem reversa podem estar no máximo N-2 tokens separadas. N não pode ser maior que 6. Exemplo: "social media"~5 OR "API"~3
contains:	Busca por substring em Posts com a substring especificada no corpo, independentemente da tokenização. Use aspas duplas para substrings com espaços em branco ou pontuação. Exemplo: (contains:social OR contains:"wikipedia.com") -contains:"buy now"
from:	Encontra qualquer Post de um usuário específico por id de Conta numérico do X ou nome de usuário (excluindo @). Exemplo: (from:2244994945 OR from:api OR from:twittereng) -from:jack
to:	Encontra qualquer Post respondendo a um usuário específico por id de Conta numérico do X ou nome de usuário (excluindo @). Exemplo: (to:2244994945 OR to:api OR to:twittereng) -to:jack
url:	Executa uma busca tokenizada (palavra-chave/frase) em URLs expandidas de um post. Exemplo: @XDevelopers url:"developer.x.com"
url_title:	Executa uma busca de palavra-chave/frase nos metadata do título HTML da URL expandida. Disponível apenas com PowerTrack e Historical PowerTrack.
url_description:	Executa uma busca de palavra-chave/frase nos metadata de descrição da página expandida. Disponível apenas com PowerTrack e Historical PowerTrack.
url_contains:	Encontra Posts com URLs contendo a frase ou palavra-chave especificada. Coloque termos de busca com pontuação entre aspas. Exemplo: (url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit
bio:	Encontra uma palavra-chave ou frase na biografia do usuário de um Post. Esta é uma busca tokenizada no campo ‘description’ do objeto de usuário. Exemplo: (bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:troll Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
bio_name:	Encontra uma palavra-chave no nome da biografia do usuário de um Post. Esta é uma busca tokenizada no campo “name” de um usuário no objeto de usuário. Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
bio_location:	Encontra Posts onde a localização do objeto de usuário contém a palavra-chave ou frase especificada. Este operador executa uma busca tokenizada, similar às regras normais de palavra-chave no corpo da mensagem. Esta localização faz parte do objeto de usuário, e é a localização ‘principal’ da conta. Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
statuses_count:	Encontra Posts quando o autor postou um número de statuses dentro do intervalo especificado. Se um único número for especificado, qualquer número igual ou maior será encontrado. Um intervalo pode ser especificado para encontrar qualquer número no intervalo (ex.: statuses_count:1000..10000). Exemplo: to:api statuses_count:10 Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
followers_count:	Encontra Posts quando o autor tem uma contagem de seguidores dentro do intervalo especificado. Se um único número for especificado, qualquer número igual ou maior será encontrado. Um intervalo pode ser especificado para encontrar qualquer número no intervalo (ex.: followers_count:1000..10000). Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
friends_count:	Encontra Posts quando o autor tem uma contagem de amigos (o número de usuários que eles seguem) dentro do intervalo especificado. Se um único número for especificado, qualquer número igual ou maior será encontrado. Um intervalo pode ser especificado para encontrar qualquer número no intervalo (ex.: friends_count:1000..10000). Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
listed_count:	Encontra Posts quando o autor foi listado no X um certo número de vezes dentro do intervalo especificado. Se um único número for especificado, qualquer número igual ou maior será encontrado. Um intervalo pode ser especificado para encontrar qualquer número no intervalo (ex.: listed_count:10..100). Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
$	Encontra qualquer Post que contém a entidade ‘cashtag’ especificada. Exemplo: ($TWTR OR $TSLA OR $BRK.A) -$F Nota: O operador cashtag depende da extração de entidade ‘symbols’ do X para encontrar cashtags, ao invés de extraí-lo do próprio corpo.
retweets_of:	Encontra Posts que são Retweets de um usuário especificado. Aceita tanto nomes de usuário quanto ids de Conta numéricos do X (NÃO ids de status de Post). Exemplo: (retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack
retweets_of_status_id:	Entrega apenas Retweets explícitos do Post especificado. Use o id de um Post original e não de um Retweet. Exemplo: retweets_of_status_id:1293593516040269825 Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
in_reply_to_status_id:	Entrega apenas respostas explícitas ao Post especificado. Exemplo: in_reply_to_status_id:1293593516040269825 Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
sample:	Retorna uma amostra aleatória de Posts que atendem a uma regra. A porcentagem da amostra deve ser um número inteiro entre 1 e 100. O operador reduz o escopo para X%, então a regra/filtro é aplicada a esse subconjunto amostrado. Exemplo: #happybirthday sample:5 "happy birthday"~5 sample:80 Nota: Disponível apenas com PowerTrack e Historical PowerTrack.
source:	Encontra qualquer Post gerado pela aplicação fonte especificada. O valor pode ser o nome da aplicação ou a URL da aplicação. Exemplo: #happybirthday source:"X for iPhone" "This is a test X from my TestingApp" source:MyTestAppName Nota: O operador source busca no atributo fonte do Post e não pode ser usado sozinho.
lang:	Encontra Posts classificados pelo X como estando em um idioma específico. Posts são atualmente classificados como apenas um idioma, então buscar múltiplos idiomas não produz resultados. Não recomendado usar sozinho.

A lista abaixo apresenta os idiomas atualmente compatíveis e seus respectivos identificadores de idioma BCP 47:

Amárico: am	Alemão: de	Malaiala: ml	Eslovaco: sk
Árabe: ar	Grego: el	Maldivo: dv	Esloveno: sl
Armênio: hy	Guzerate: gu	Marata: mr	Curdo Sorâni: ckb
Basco: eu	Crioulo haitiano: ht	Nepalês: ne	Espanhol: es
Bengalês: bn	Hebraico: iw	Norueguês: no	Sueco: sv
Bósnio: bs	Hindi: hi	Oriá: or	Tagalog: tl
Búlgaro: bg	Hindi latinizado: hi-Latn	Panjabi: pa	Tâmil: ta
Birmanês: my	Húngaro: hu	Pachto: ps	Télugo: te
Croata: hr	Islandês: is	Persa: fa	Tailandês: th
Catalão: ca	Indonésio: in	Polonês: pl	Tibetano: bo
Tcheco: cs	Italiano: it	Português: pt	Chinês tradicional: zh-TW
Dinamarquês: da	Japonês: ja	Romeno: ro	Turco: tr
Holandês: nl	Canará: kn	Russo: ru	Ucraniano: uk
Inglês: en	Khmer: km	Sérvio: sr	Urdu: ur
Estoniano: et	Coreano: ko	Chinês simplificado: zh-CN	Uigur: ug
Finlandês: fi	Lao: lo	Sindi: sd	Vietnamita: vi
Francês: fr	Letão: lv	Cingalês: si	Galês: cy
Georgiano: ka	Lituano: lt

Exemplo:

(@XDevelopers OR to:XDevelopers) lang:es

Observação: o operador de idioma corresponde ao idioma específico do Post determinado pela X e definido como o atributo lang do Post. Consulte aqui para mais informações sobre os atributos JSON de X Entities. Se não for possível classificar o idioma de um Post, o atributo lang do Post será definido como “und” (indefinido).

Operador	Descrição
place	Corresponde a Posts marcados com a localização especificada ou ID de local do X. Nomes de locais com múltiplas palavras devem ser colocados entre aspas. Exemplo: (place:London OR place:"Great Britain") -place:USA place:fd70c22040963ac7 Observação: Consulte o endpoint da API pública GET geo/search para saber como obter IDs de local do X. Observação: Não corresponderá a Retweets ou Quote Tweets, pois os locais de Retweet estão vinculados ao Post original.
place_country	Corresponde a Posts onde o código do país associado a um local/localização marcado corresponde ao código de caractere alfa-2 ISO fornecido. Exemplo: place_country:GB OR place_country:AU OR place_country:CA Observação: Não corresponderá a Retweets ou Quote Tweets, pois os locais de Retweet estão vinculados ao Post original. Códigos ISO válidos: ISO 3166-1 alpha-2.
point_radius:[lon lat radius]	Corresponde à Localização Exata (x,y) do Post ou um polígono geográfico de “Local” dentro do raio definido. _ Raio: < 25mi _ Unidades suportadas: mi, km _ Longitude: ±180 _ Latitude: ±90 As coordenadas estão em graus decimais. Os argumentos são colocados entre colchetes, delimitados por espaço. Exemplo: point_radius:[-105.27346517 40.01924738 0.5mi] Exemplo: point_radius:[2.355128 48.861118 16km] Observação: Não corresponderá a Retweets ou Quote Tweets.
bounding_box:[west_long south_lat east_long north_lat]	Corresponde à Localização Exata ou um polígono geográfico de “Local” totalmente contido em uma caixa delimitadora. Os argumentos são colocados entre colchetes, delimitados por espaço. Coordenadas: graus decimais (±180 long, ±90 lat). Largura e altura devem ser < 25mi. Exemplo: bounding_box:[-105.301758 39.964069 -105.178505 40.09455] Observação: Não corresponderá a Retweets ou Quote Tweets.
profile_country	Corresponde a Posts onde o código do país geográfico do perfil do autor corresponde a um código de duas letras ISO-3166-1-alpha-2 fornecido.
profile_region	Corresponde ao campo “region” do enriquecimento geográfico do perfil do autor, uma correspondência exata de string completa. Use aspas duplas para substrings contendo espaços em branco ou pontuação. Exemplo: profile_region:"New York"
profile_locality	Corresponde ao campo “locality” do enriquecimento geográfico do perfil do autor, uma correspondência exata de string completa. Use aspas duplas para substrings contendo espaços em branco ou pontuação. Exemplo: profile_locality:"San Francisco"
profile_subregion	Corresponde ao campo “subRegion” do enriquecimento geográfico do perfil do autor, incluindo condados específicos ou áreas metropolitanas. Uma correspondência exata de string completa. Exemplo: profile_subregion:"Santa Clara County"
has:geo	Corresponde a Posts com dados de localização geográfica específicos do Post do X, incluindo dados de localização “geo” lat-long ou “Place” com um nome de exibição e polígono geográfico. Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
has:profile_geo	Corresponde a Posts com qualquer metadata de Geo do Perfil, independentemente do valor. Alias disponível: has:derived_user_geo. Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
has:links	Corresponde a Posts com um link ou mídia referenciada no objeto “text” do payload, incluindo mídia e Quote Tweets. Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
is:retweet	Retorna apenas retweets explícitos. Pode ser negado para excluir retweets e retornar apenas conteúdo original. Este operador procura apenas por Retweets verdadeiros e não Quoted Tweets. Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
is:reply	Retorna apenas respostas explícitas. Pode ser negado para excluir respostas. PowerTrack corresponde a respostas a Posts originais, respostas em Posts citados e respostas em Retweets. A API de Pesquisa corresponde apenas a respostas a Posts originais. Exemplo: @XDevelopers -is:reply
is:quote	Retorna apenas Quote Tweets ou Posts que referenciam outro Post. Pode ser negado para excluir Quote Tweets. Exemplo: @XDevelopers is:quote
is:verified	Retorna apenas Posts de autores “verificados”. Pode ser negado para excluir Posts de autores verificados. Exemplo: @XDevelopers is:verified
has:mentions	Corresponde a Posts mencionando outro usuário do X. Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
has:hashtags	Corresponde a Posts contendo uma hashtag. Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
has:media	Corresponde a Posts contendo uma URL de mídia classificada pelo X (por exemplo, pic.x.com). Alias disponível: has:media_link. Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
has:images	Corresponde a Posts contendo uma URL de mídia (por exemplo, pic.x.com). Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
has:videos	Corresponde a Posts contendo vídeos nativos do X enviados para o X. Alias disponível: has:video_link. Este operador não corresponde a vídeos do YouTube, Periscope ou outros sites de hospedagem de vídeo. Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.
has:symbols	Corresponde a Posts contendo um símbolo cashtag (por exemplo, $TWTR). Observação: Com a API de Pesquisa, deve ser combinado com operadores que não sejam is: ou has:.

​

Operadores por produto

​

Regras e filtragem: Enterprise

Todos os operadores do Enterprise estão disponíveis nas APIs PowerTrack e Historical PowerTrack. No entanto, apenas um subconjunto de operadores está disponível nas APIs de Search do Enterprise, conforme indicado nesta página.

As tags em azul-escuro indicam quais operadores estão disponíveis em diferentes produtos do Enterprise:

PowerTrack Search

Operador	Produto	Descrição	Corresponde ao elemento de payload
”correspondência exata de frase”	PowerTrack Search	Corresponde a uma frase exata dentro do corpo de um Post. Componentes que podem se transformar em operadores de busca serão tratados como palavras. Em outras palavras: _ "#hashtag" corresponderá a hashtag mas não a #hashtag (use o operador hashtag sem aspas para corresponder a hashtags reais) _ "$TWTR" corresponderá à palavra TWTR mas não ao cashtag $TWTR (use o operador cashtag sem aspas para corresponder a cashtags reais) Observação: no 30 Day Search e Full Archive Search (Enterprise e Premium), a pontuação não é tokenizada e é tratada como espaço em branco.	text
@	PowerTrack Search	Corresponde a qualquer Post que mencione o nome de usuário fornecido. O valor pode ser o nome de usuário (excluindo o caractere @) ou o ID numérico do usuário (obtido, por exemplo, através do endpoint GET users/lookup).	entities.user_mentions
#	PowerTrack Search	Corresponde a qualquer Post com a hashtag fornecida. Este operador executa uma correspondência exata. Por exemplo, a regra #1989 corresponderá a Posts contendo exatamente a hashtag #1989, mas não àqueles com a hashtag #TaylorSwift1989. Observação: este operador depende da extração de entidades do X para corresponder a hashtags, em vez de extrair a hashtag do próprio corpo. Para mais detalhes sobre atributos JSON de entidades, consulte X Entities.	entities.hashtags
$	PowerTrack Search	Corresponde a qualquer Post que contenha o cashtag especificado (onde o caractere inicial do token é $). Observação: este operador depende da extração de entidades do X para corresponder a links, em vez de extrair o link do próprio corpo. Para mais detalhes sobre atributos JSON de entidades, consulte X Entities.	entities.symbols
bio:	PowerTrack	Alias disponível: user_bio: Corresponde a uma palavra-chave (usando correspondência tokenizada) ou uma frase dentro da biografia do usuário de um Post. Use aspas duplas para corresponder a uma frase. Em outras palavras: _ bio:software engineer corresponderá a Posts com a palavra-chave engineer de usuários com a palavra software em sua biografia _ bio:"software engineer" corresponderá a qualquer Post publicado por usuários com a frase software engineer em sua biografia	user``.description
bio_location:	PowerTrack	Alias disponível: user_bio_location: Corresponde a Posts onde a localização do objeto de usuário contém a palavra-chave especificada (usando correspondência tokenizada) ou frase. Esta localização é uma string não normalizada, gerada pelo usuário e de formato livre, e é diferente da localização de um Post (quando disponível).	user.location
bio_name:	PowerTrack	Corresponde a Posts onde o nome do objeto de usuário contém a palavra-chave especificada (usando correspondência tokenizada) ou frase.	user.name
bounding_box:	PowerTrack Search	Alias disponível: geo_bounding_box: Corresponde à localização exata (longitude, latitude) do Post (quando presente), e a um polígono geográfico (onde o Place está totalmente contido dentro da região definida). _ west_long south_lat representam o canto sudoeste da caixa delimitadora onde west-long é a longitude desse ponto, e south_lat é a latitude. _ east_long e north_lat representam o canto nordeste da caixa delimitadora, onde east_long é a longitude desse ponto, e north_lat é a latitude. _ A largura e altura da caixa delimitadora devem ser menores que 25 milhas _ A longitude está no intervalo de ±180 _ A latitude está no intervalo de ±90 _ Todas as coordenadas estão em graus decimais. * Os argumentos da regra estão contidos entre colchetes, delimitados por espaço. Observação: operadores que correspondem a place (geo do Post) incluirão apenas correspondências de Posts originais. Retweets não contêm dados de place.	place (apenas Posts originais)
contains:	PowerTrack	Correspondência de substring para Posts que têm a substring fornecida no corpo, independentemente da tokenização. Em outras palavras, isso faz uma correspondência pura de substring e não considera limites de palavras. Use aspas duplas para corresponder a substrings que contenham espaços em branco ou pontuação.	text
<emoji>	PowerTrack Search	Corresponde a um emoji dentro do corpo de um Post. Esta é uma correspondência tokenizada, então seu emoji será comparado ao texto tokenizado do corpo do Post. A tokenização é baseada em pontuação, símbolo/emoji e caracteres separadores do plano básico Unicode. Por exemplo, um Post com o texto “I like 🍕” seria dividido nos seguintes tokens: I, like, 🍕. Esses tokens seriam então comparados ao emoji usado em sua regra. Observação: se um emoji tem uma variante, você deve usar aspas duplas para adicionar a uma regra.	text
followers_count:	PowerTrack	Corresponde a Posts quando o autor tem uma contagem de seguidores dentro do intervalo fornecido. _ Um único número (ex. followers_count:42) corresponderá a qualquer número igual ou maior que o valor especificado. _ Um intervalo (ex. followers_count:42..1337) corresponderá a qualquer número no intervalo fornecido.	user.followers_count
friends_count:	PowerTrack	Alias disponível: following_count: Corresponde a Posts quando o autor tem uma contagem de amigos (o número de usuários que eles seguem) que está dentro do intervalo fornecido. _ Um único número (ex. followers_count:42) corresponderá a qualquer número igual ou maior que o valor especificado. _ Um intervalo (ex. followers_count:42..1337) corresponderá a qualquer número no intervalo fornecido.	user.friends_count
from:	PowerTrack Search	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 (obtido, por exemplo, através do endpoint GET users/lookup).	user.id, user.id_str (se usando ID do usuário) user.screen_name (se usando nome de usuário)
has:geo	PowerTrack Search	Corresponde a Posts que têm dados de geolocalização específicos do Post fornecidos pelo X. Isso pode ser coordenadas “geo” lat-long, ou uma “location” na forma de um Place do X, com o nome de exibição correspondente, polígono geográfico e outros campos. Não pode ser usado como um operador independente. Observação: operadores que correspondem a place (geo do Post) incluirão apenas correspondências de Posts originais. Retweets não contêm dados de place.	place (apenas Posts originais)
has:hashtags	PowerTrack Search	Corresponde a Posts que contêm pelo menos uma hashtag. Não pode ser usado como operador independente.	entities.hashtags
has:images	PowerTrack Search	Corresponde a Posts que contêm pelo menos uma URL de imagem classificada. Não pode ser usado como operador independente.	entities.media
has:lang	PowerTrack	Corresponde a Posts que foram classificados pelo X como sendo de um idioma específico. Se um Post não foi classificado, o operador não irá corresponder. Cada Post é atualmente classificado como sendo de apenas um idioma, então usar AND com múltiplos idiomas não retornará resultados. Não pode ser usado como operador independente.	lang quando o valor não é und
has:links	PowerTrack Search	Este operador corresponde a Posts que contêm links no corpo do Post. Não pode ser usado como operador independente. Observação: este operador depende da extração de entidades do X para corresponder links, em vez de extrair o link do próprio corpo. Para mais detalhes sobre atributos JSON de entidades, consulte X Entities.	entities.urls
has:media	PowerTrack Search	Alias disponível: has:media_link Corresponde a Posts que contêm pelo menos uma URL de mídia classificada. Não pode ser usado como operador independente.	entities.media
has:mentions	PowerTrack Search	Corresponde a Posts que mencionam outro usuário do X. Não pode ser usado como operador independente.	entities.user_mentions
has:profile_geo	PowerTrack Search	Alias disponível: has:derived_user_geo Corresponde a Posts que possuem qualquer metadata de Profile Geo, independentemente do valor real. Não pode ser usado como operador independente.	user.location
has:symbols	PowerTrack Enterprise	Corresponde a Posts que contêm um símbolo cashtag (ex.: $TWTR). Não pode ser usado como operador independente.	entities.symbols
has:videos	PowerTrack Search	Alias disponível: has:video_link Corresponde a Posts que contêm pelo menos uma URL de mídia classificada. Não pode ser usado como operador independente.	entities.media
in_reply_to_status_id:	PowerTrack	Alias disponível: in_reply_to_tweet_id: Entrega apenas respostas explícitas ao Post especificado.	id, id_str do Post de destino
is:quote	PowerTrack	Entrega Quote Tweets explícitos que correspondem a uma regra. Também pode ser negado (-is:quote) para excluir Quote Tweets que correspondem a uma regra da entrega. Não pode ser usado como operador independente.	is_quote_status (se true)
is:reply	PowerTrack Search	Entrega apenas respostas que correspondem a uma regra. Também pode ser negado (-is:reply) para excluir a entrega de respostas que correspondem à regra especificada. Com PowerTrack, este operador corresponde a: _ Respostas a um Post original _ Respostas em Posts citados * Respostas em Retweets Quando usado com a API Search, este operador corresponde a respostas a um Post original, mas exclui respostas em Tweets citados e respostas em Retweets. Você pode usar este operador em conjunto com is:retweet e is:quote para entregar apenas respostas a Posts originais. Não pode ser usado como operador independente com a API Search. Observação: com Premium, este operador não está disponível em ambientes de desenvolvimento Sandbox.	Elementos de resposta, ex.: in_reply_to_status_id
is:retweet	PowerTrack Search	Entrega apenas Retweets explícitos que correspondem a uma regra. Também pode ser negado (-is:retweet) para excluir Retweets que correspondem a uma regra da entrega e apenas conteúdo original é entregue. Este operador procura apenas por Retweets verdadeiros (ou seja, Retweets postados usando o botão Retweet). Quote Tweets e Posts modificados que não usam a funcionalidade de Retweet do X não serão correspondidos por este operador. Não pode ser usado como operador independente.	Elementos de Retweet, ex.: retweeted_status
is:verified	PowerTrack Search	Entrega apenas Posts onde o autor é verificado pelo X. Também pode ser negado para excluir Posts onde o autor é verificado. Não pode ser usado como operador independente.	user.verified
keyword	PowerTrack Search	Corresponde a uma palavra-chave dentro do corpo de um Post. Esta é uma correspondência tokenizada, significando que sua string de palavra-chave será comparada com o texto tokenizado do corpo do Post. A tokenização é baseada em pontuação, símbolo/emoji 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 com a string de palavra-chave usada em sua regra. Para corresponder strings contendo pontuação (ex.: coca-cola), símbolo ou caracteres separadores, você deve usar um operador de correspondência de frase exata.	text
lang:	PowerTrack Search	Corresponde a Posts que foram classificados pelo X como sendo de um idioma específico (se, e somente se, o post foi classificado). Cada Post será classificado com apenas um idioma, então usar AND com múltiplos idiomas não retornará resultados. **Observação: **se nenhuma classificação de idioma puder ser feita, o resultado fornecido é und (para indefinido). Este operador corresponderá apenas a idiomas suportados. Fornecer qualquer outro valor (incluindo und) resultará no operador sendo ignorado (em outras palavras, Posts não serão filtrados por este operador). A lista abaixo representa os idiomas atualmente suportados e seus identificadores de idioma BCP 47 correspondentes: am Amárico hu Húngaro pt Português ar Árabe is Islandês ro Romeno hy Armênio in Indonésio ru Russo bn Bengali it Italiano sr Sérvio bg Búlgaro ja Japonês sd Sindi my Birmanês kn Canarês si Cingalês zh Chinês km Khmer sk Eslovaco cs Tcheco ko Coreano sl Esloveno da Dinamarquês lo Laosiano ckb Curdo Sorani nl Holandês lv Letão es Espanhol en Inglês lt Lituano sv Sueco et Estoniano ml Malaiala tl Tagalo fi Finlandês dv Maldivo ta Tâmil fr Francês mr Marati te Telugu ka Georgiano ne Nepalês th Tailandês de Alemão no Norueguês bo Tibetano el Grego or Oriya tr Turco gu Gujarati pa Punjabi uk Ucraniano ht Haitiano ps Pashto ur Urdu iw Hebraico fa Persa ug Uigur hi Hindi pl Polonês vi Vietnamita cy Galês	lang quando o valor não é und
listed_count:	PowerTrack	Alias disponível: user_in_lists_count: Corresponde a Posts quando o autor foi listado no X um número de vezes que está dentro do intervalo especificado. _ Um único número (ex. listed_count:42) corresponderá a qualquer número igual ou maior que o valor especificado. _ Um intervalo (ex. listed_count:42..1337) corresponderá a qualquer número no intervalo especificado.	user.listed_count
place_country:	PowerTrack Search	Corresponde a Posts onde o código do país associado a um local/localização marcado corresponde ao código de caractere alfa-2 ISO fornecido. Observação: operadores que correspondem a local (geo do Post) incluirão apenas correspondências de Posts originais. Retweets não contêm dados de local.	place (apenas Posts originais)
place:	PowerTrack Search	Corresponde a Posts marcados com localização especificada ou ID de local do X. Nomes de locais com múltiplas palavras devem ser colocados entre aspas (ex. place:"San Francisco") Observação: operadores que correspondem a local (geo do Post) incluirão apenas correspondências de Posts originais. Retweets não contêm dados de local.	place (apenas Posts originais)
point_radius:	PowerTrack Search	Observação: operadores que correspondem a local (geo do Post) incluirão apenas correspondências de Posts originais. Retweets não contêm dados de local.	place (apenas Posts originais)
profile_bounding_box:[west_long south_lat east_long north_lat]	PowerTrack	Corresponde à Localização exata do usuário (long, lat) no enriquecimento de Geo do Perfil onde o Local está totalmente contido dentro da região definida. _ west_long south_lat representam o canto sudoeste da caixa delimitadora onde west-long é a longitude desse ponto, e south_lat é a latitude. _ east_long e north_lat representam o canto nordeste da caixa delimitadora, onde east_long é a longitude desse ponto, e north_lat é a latitude. _ Largura e altura da caixa delimitadora devem ser menores que 25mi _ Longitude está no intervalo de ±180 _ Latitude está no intervalo de ±90 _ Todas as coordenadas estão em graus decimais. * Argumentos da regra estão contidos dentro de colchetes, delimitados por espaço. Observação: operadores que correspondem a local (geo do Post) incluirão apenas correspondências de Posts originais. Retweets não contêm dados de local.	user.derived.locations.geo.coordinates
profile_country:	PowerTrack Search	Correspondência exata no código do país do enriquecimento de Geo do Perfil. Usa um conjunto normalizado de códigos de país de duas letras, baseado na especificação ISO-3166-1-alpha-2. Para ser conciso, este operador é fornecido em lugar de um operador para o campo país do objeto de endereço. Observação: operadores que correspondem a local (geo do Post) incluirão apenas correspondências de Posts originais. Retweets não contêm dados de local.	user.derived.locations.country_code
profile_locality:	PowerTrack Search	Correspondência exata no campo Localidade do enriquecimento de Geo do Perfil. Esta é uma correspondência exata de string completa. Não é necessário escapar caracteres com barra invertida. Por exemplo, se corresponder a algo com uma barra, use one/two. Use aspas duplas para corresponder a substrings que contenham espaços em branco ou pontuação, ex. profile_locality:"Lower East Side".	user.derived.locations.locality
profile_point_radius:[lon lat radius]	PowerTrack	Corresponde à Localização Exata (x,y) do enriquecimento de Geo do Perfil do usuário. _ Unidades de raio suportadas são milhas (mi) e quilômetros (km). _ Raio deve ser menor que 25mi. _ Longitude está no intervalo de ±180 _ Latitude está no intervalo de ±90 _ Todas as coordenadas estão em graus decimais. _ Argumentos da regra estão contidos dentro de colchetes, delimitados por espaço. Observação: operadores que correspondem a local (geo do Post) incluirão apenas correspondências de Posts originais. Retweets não contêm dados de local.	user.derived.locations.geo
profile_region:	PowerTrack Search	Correspondência exata no campo Region do enriquecimento Profile Geo. Esta é uma correspondência exata da string completa. Não é necessário escapar caracteres com barra invertida. Por exemplo, ao fazer correspondência com algo que contenha uma barra, use one/two. Use aspas duplas para fazer correspondência com substrings que contenham espaços em branco ou pontuação, por exemplo profile_locality:"New York".	user.derived.locations.region
profile_subregion:	PowerTrack	Correspondência exata no campo Subregion do enriquecimento Profile Geo. Esta é uma correspondência exata da string completa. Não é necessário escapar caracteres com barra invertida. Por exemplo, ao fazer correspondência com algo que contenha uma barra, use one/two. Use aspas duplas para fazer correspondência com substrings que contenham espaços em branco ou pontuação, por exemplo profile_locality:"Kings County".	user.derived.locations.sub_region
”keyword1 keyword2”~N	PowerTrack Search	Comumente conhecido como operador de proximidade, corresponde a um Post onde as palavras-chave estão a no máximo N tokens de distância uma da outra. Se as palavras-chave estiverem em ordem inversa, não podem estar a mais de N-2 tokens de distância uma da outra. Pode conter qualquer número de palavras-chave entre aspas. N não pode ser maior que 6.	text
retweets_of_status_id:	PowerTrack	Alias disponível: retweets_of_tweet_id: Entrega apenas Retweets explícitos do Post original especificado.	retweeted_status.id, retweeted_status.id_str
retweets_of:	PowerTrack Search	Alias disponível: retweets_of_user: Corresponde a qualquer Post que seja Retweet do usuário especificado. O valor pode ser o nome de usuário (excluindo o caractere @) ou o ID numérico do usuário (obtido, por exemplo, através do endpoint GET users/lookup).	retweeted_status.id (se presente)
sample:	PowerTrack	Retorna uma amostra percentual aleatória de Posts que correspondem a uma regra, em vez do conjunto completo de Posts. O valor percentual deve ser representado por um número inteiro entre 1 e 100. Este operador se aplica à regra inteira e requer que todos os termos com OR sejam agrupados. Nota: o operador sample primeiro reduz o escopo do firehose para X%, depois a regra/filtro é aplicada a esse subconjunto amostrado. Se você estiver usando, por exemplo, sample:10, cada Post tem 10% de chance de estar na amostra. Nota: a amostragem é determinística, e você obterá a mesma amostra de dados em tempo real que obteria se extraísse os dados historicamente.
source:	PowerTrack	Corresponde a qualquer Post gerado pela aplicação de origem especificada. O valor deve ser o nome da aplicação ou a URL da aplicação. Não pode ser usado como operador independente.	source
statuses_count:	PowerTrack	Alias disponível: tweets_count: Corresponde a Posts quando o autor postou um número de statuses que está dentro do intervalo especificado. _ Um único número (por exemplo statuses_count:42) corresponderá a qualquer número igual ou maior que o valor especificado. _ Um intervalo (por exemplo statuses_count:42..1337) corresponderá a qualquer número dentro do intervalo especificado.	user``.statuses_count
to:	PowerTrack Search	Corresponde a qualquer Post que seja 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 (obtido, por exemplo, através do endpoint GET users/lookup).	text
url:	PowerTrack Search	Executa uma correspondência tokenizada nas URLs expandidas de um Post. Tokens e frases contendo pontuação ou caracteres especiais devem estar entre aspas duplas (por exemplo url:"/developer"). Embora geralmente não seja recomendado, o operador também pode corresponder a um protocolo específico, entre aspas duplas (por exemplo url:"https://developer.x.com").	entities.urls.expanded_url
url_contains:	PowerTrack	Executa uma correspondência de palavra-chave/frase no (novo) enriquecimento de metadata de título de URL expandida.	entities.urls.expanded_url
url_description:	PowerTrack	Alias disponível: within_url_description: Executa uma correspondência de palavra-chave/frase no (novo) enriquecimento de metadata de descrição de página expandida.	entities.urls.unwound.description
url_title:	PowerTrack	Alias disponível: within_url_title: Executa uma correspondência de palavra-chave/frase no (novo) enriquecimento de metadata de título de URL expandida.	entities.urls.title