Operadores de busca

Esta página fornece uma lista completa dos operadores disponíveis ao criar uma query para os endpoints da Search API.

Visão geral

Os operadores são usados para corresponder a atributos específicos de Post. Existem dois tipos:

Operadores independentes — Podem ser usados sozinhos ou com quaisquer outros operadores
Operadores que exigem conjunção — Devem ser usados com pelo menos um operador independente

Operadores de palavra-chave e frase

Operador	Tipo	Resumo	Exemplo
`keyword`	Independente	Corresponde a uma palavra-chave no corpo do Post (correspondência tokenizada)	`pepsi OR cola OR "coca cola"`
`emoji`	Independente	Corresponde a um emoji no corpo do Post	`(😃 OR 😡) 😬`
`"exact phrase"`	Independente	Corresponde à frase exata no corpo do Post	`("X API" OR #v2) -"recent search"`

Operadores de entidade

Operador	Tipo	Resumo	Exemplo
`#`	Independente	Corresponde a Posts que contêm uma hashtag (correspondência exata)	`#thankunext #fanart`
`@`	Independente	Corresponde a Posts que mencionam um nome de usuário	`(@XDevelopers OR @API) -@X`
`$`	Independente	Corresponde a Posts que contêm uma cashtag	`$twtr OR @XDevelopers -$fb`

Operadores de usuário

Operador	Tipo	Resumo	Exemplo
`from:`	Independente	Corresponde a Posts de um usuário específico	`from:XDevelopers OR from:API`
`to:`	Independente	Corresponde a Posts em resposta a um usuário específico	`to:XDevelopers OR to:API`
`retweets_of:`	Independente	Corresponde a Retweets de um usuário específico	`retweets_of:twitterdev`

Operadores de URL

Operador	Tipo	Resumo	Exemplo
`url:`	Independente	Correspondência tokenizada em URL (corresponde aos fields `url` ou `expanded_url`)	`url:"https://developer.twitter.com"`

Operadores de context e entity

Operador	Tipo	Resumo	Exemplo
`context:`	Independente	Corresponde a Posts com um par domain/entity específico	`context:10.799022225751871488`
`entity:`	Independente	Corresponde a Posts com um valor de string de entity específico (apenas recent search)	`entity:"Michael Jordan"`
`conversation_id:`	Independente	Corresponde a Posts em uma thread de conversa	`conversation_id:1334987486343299072`

Operador de lista

Operador	Tipo	Resumo	Exemplo
`list:`	Independente	Corresponde a Posts de membros de uma List específica	`list:123`

Operadores de referência de Post

Operador	Tipo	Resumo	Exemplo
`in_reply_to_tweet_id:`	Independente	Corresponde a replies a um Post específico	`in_reply_to_tweet_id:1539382664746020864`
`retweets_of_tweet_id:`	Independente	Corresponde a Retweets de um Post específico	`retweets_of_tweet_id:1539382664746020864`
`quotes_of_tweet_id:`	Independente	Corresponde a Quote Tweets de um Post específico	`quotes_of_tweet_id:1539382664746020864`

Operadores de localização

Operador	Tipo	Resumo	Exemplo
`place:`	Independente	Corresponde a Posts marcados com uma localização	`place:"new york city" OR place:seattle`
`place_country:`	Independente	Corresponde a Posts com um código de país	`place_country:US OR place_country:MX`
`point_radius:`	Independente	Corresponde a Posts dentro de um raio de um ponto	`point_radius:[2.355128 48.861118 16km]`
`bounding_box:`	Independente	Corresponde a Posts dentro de uma bounding box	`bounding_box:[-105.301758 39.964069 -105.178505 40.09455]`

Operadores de tipo de Post

Operador	Tipo	Resumo	Exemplo
`is:retweet`	Exige conjunção	Corresponde a Retweets	`data @XDevelopers -is:retweet`
`is:reply`	Exige conjunção	Corresponde a replies	`from:XDevelopers is:reply`
`is:quote`	Exige conjunção	Corresponde a Quote Tweets	`"sentiment analysis" is:quote`
`is:verified`	Exige conjunção	Corresponde a Posts de autores verificados	`#nowplaying is:verified`
`-is:nullcast`	Exige conjunção	Exclui Posts promocionais (deve ser negado)	`"mobile games" -is:nullcast`

Operadores de tipo de conteúdo

Operador	Tipo	Resumo	Exemplo
`has:hashtags`	Exige conjunção	Corresponde a Posts com hashtags	`from:XDevelopers -has:hashtags`
`has:cashtags`	Exige conjunção	Corresponde a Posts com cashtags	`#stonks has:cashtags`
`has:links`	Exige conjunção	Corresponde a Posts com links	`from:XDevelopers has:links`
`has:mentions`	Exige conjunção	Corresponde a Posts com menções	`#nowplaying has:mentions`
`has:media`	Exige conjunção	Corresponde a Posts com mídia (foto, GIF, vídeo)	`(kittens OR puppies) has:media`
`has:images`	Exige conjunção	Corresponde a Posts com imagens	`#meme has:images`
`has:video_link`	Exige conjunção	Corresponde a Posts com vídeos nativos do X	`#icebucketchallenge has:video_link`
`has:geo`	Exige conjunção	Corresponde a Posts com dados de geolocalização	`recommend #paris has:geo`

Operador de idioma

Operador	Tipo	Resumo	Exemplo
`lang:`	Exige conjunção	Corresponde a Posts classificados como um idioma específico	`recommend #paris lang:en`

Operadores lógicos

Operador	Resumo	Exemplo
`OR`	OR lógico entre expressões	`cat OR dog`
Espaço (AND)	AND lógico entre expressões	`cat dog` (ambos obrigatórios)
`()`	Agrupamento para expressões complexas	`(cat OR dog) -is:retweet`
`-`	Negação/exclusão	`cat -grumpy`

Idiomas suportados

O operador lang: suporta estes códigos de idioma BCP 47:

Idioma	Código	Idioma	Código	Idioma	Código
Amárico	`am`	Grego	`el`	Português	`pt`
Árabe	`ar`	Guzerate	`gu`	Romeno	`ro`
Armênio	`hy`	Hebraico	`iw`	Russo	`ru`
Basco	`eu`	Hindi	`hi`	Sérvio	`sr`
Bengali	`bn`	Húngaro	`hu`	Chinês Simplificado	`zh-CN`
Búlgaro	`bg`	Indonésio	`in`	Eslovaco	`sk`
Catalão	`ca`	Italiano	`it`	Esloveno	`sl`
Croata	`hr`	Japonês	`ja`	Espanhol	`es`
Tcheco	`cs`	Canarês	`kn`	Sueco	`sv`
Dinamarquês	`da`	Coreano	`ko`	Tâmil	`ta`
Holandês	`nl`	Letão	`lv`	Telugu	`te`
Inglês	`en`	Lituano	`lt`	Tailandês	`th`
Estoniano	`et`	Malaiala	`ml`	Chinês Tradicional	`zh-TW`
Finlandês	`fi`	Marata	`mr`	Turco	`tr`
Francês	`fr`	Norueguês	`no`	Ucraniano	`uk`
Alemão	`de`	Persa	`fa`	Urdu	`ur`
Georgiano	`ka`	Polonês	`pl`	Vietnamita	`vi`

Limitações da query

Nível de acesso	Recent search	Full-archive search
Self-serve	512 caracteres	1.024 caracteres
Enterprise	4.096 caracteres	4.096 caracteres

Próximos passos

Criar uma query

Aprenda a sintaxe de query e melhores práticas

Introdução ao Search

Comece com o Search

Query Builder Tool

Crie e teste queries interativamente

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Operadores de busca

Visão geral

Operadores de palavra-chave e frase

Operadores de entidade

Operadores de usuário

Operadores de URL

Operadores de context e entity

Operador de lista

Operadores de referência de Post

Operadores de localização

Operadores de tipo de Post

Operadores de tipo de conteúdo

Operador de idioma

Operadores lógicos

Idiomas suportados

Limitações da query

Próximos passos

Criar uma query

Introdução ao Search

Query Builder Tool

​Visão geral

​Operadores de palavra-chave e frase

​Operadores de entidade

​Operadores de usuário

​Operadores de URL

​Operadores de context e entity

​Operador de lista

​Operadores de referência de Post

​Operadores de localização

​Operadores de tipo de Post

​Operadores de tipo de conteúdo

​Operador de idioma

​Operadores lógicos

​Idiomas suportados

​Limitações da query

​Próximos passos

Criar uma query

Introdução ao Search

Query Builder Tool

Visão geral

Operadores de palavra-chave e frase

Operadores de entidade

Operadores de usuário

Operadores de URL

Operadores de context e entity

Operador de lista

Operadores de referência de Post

Operadores de localização

Operadores de tipo de Post

Operadores de tipo de conteúdo

Operador de idioma

Operadores lógicos

Idiomas suportados

Limitações da query

Próximos passos