Uso de Consultas Booleanas Básicas en el API de Telegram de TrawlingWeb

Las APIs de TrawlingWeb aceptan consultas booleanas combinadas con expresiones de la sintaxis de Lucene. A continuación, mostramos algunos ejemplos prácticos que te ayudarán a tener una mejor experiencia y optimizar tus búsquedas y resultados al utilizar la API de Telegram.

Recuerda que estas expresiones booleanas solo pueden utilizarse dentro del parámetro q= en la llamada a la API y deben combinarse con los filtros y parámetros PATH necesarios.

Siempre dentro de `q=`

Las consultas booleanas o los parámetros de sintaxis de Lucene siempre deben utilizarse dentro del parámetro q= en la estructura de la URL de llamada a la API. Los elementos dentro de q= constituyen toda la consulta que se adjunta a la llamada a la API.

Operadores Booleanos esenciales AND, OR y NOT

Las consultas booleanas permiten combinar palabras clave o frases mediante operadores específicos. A continuación, te presentamos los operadores disponibles y algunos ejemplos útiles:

Operador	Uso	Ejemplo
x AND y	"x" e "y" aparecerán en los documentos recuperados.	"Messi" AND "Girona"
x OR y	En los documentos recuperados, aparecerá "x", "y" o ambos. Se recomienda el uso de paréntesis.	("Messi" OR "Girona")
NOT x	No se recuperarán los documentos que incluyan "x".	NOT "Messi"

Paréntesis

Utiliza paréntesis para encapsular declaraciones OR y asegurar que los motores de búsqueda ejecuten la consulta correctamente. El operador OR se interpreta como "Me gustaría al menos uno de estos términos."

Por ejemplo: (Barcelona OR Madrid OR París)

Comillas

Las comillas deben utilizarse para buscar frases exactas de más de una palabra. Sin comillas, podrías obtener mensajes con las palabras divididas en componentes individuales.

Por ejemplo: Casa Blanca

Sin comillas, los resultados podrían incluir mensajes que contengan Casa y Blanca, pero no necesariamente juntas. Usando comillas, indicas al sistema que solo debe devolver mensajes que incluyan la frase exacta en ese orden.

Por ejemplo: "Casa Blanca"

Uso de Sintaxis de Consultas de Lucene

Las APIs de TrawlingWeb permiten realizar consultas que pueden contener operadores booleanos combinados con expresiones de la sintaxis de Lucene, ofreciendo una poderosa herramienta para realizar búsquedas complejas y precisas. La sintaxis de consultas de Lucene está diseñada para ser intuitiva y expresiva.

A continuación, te presentamos algunas características clave y ejemplos útiles para optimizar tu experiencia de usuario:

Consulta de Término: Busca un término específico.
```
cocacola
```
Consulta de Frase: Busca una frase exacta encerrándola entre comillas dobles.
```
"coca cola con gusto a cereza"
```

Consulta con Comodines: Usa ? para reemplazar un solo carácter o * para reemplazar cero o más caracteres.

- ambigu?  : (devolvería ambiguO o ambiguA)
- ejem*    : (devolvería, entre otros, resultados que contengan palabras como, ejemPLO, ejemPLOS, ejemPLAR, ejemPLIZANTE..etc)
- *finanzas: (devolvería, entre otros, resultados que contengan palabras como, "microfinanzas", "finanzas", "macrofinanzas", etc.)

Operadores Booleanos Usa AND, OR y NOT para combinar múltiples términos o frases.

Ejemplos

AND: Este operador se usa para buscar registros que contengan ambos términos o frases.

Mcdonalds AND "Burger King"

OR: Este operador se usa para buscar registros que contengan al menos uno de los términos o frases.

Mcdonalds OR "Burger King"

NOT: Este operador se usa para excluir registros que contengan el término o frase siguiente.

Mcdonalds AND NOT "Burger King"

Consultas Específicas de atributo: Especifica atributo para buscar en partes particulares del mensaje. En Telegram los campos buscables son text, user_name (handle/@slug del canal) y user_screen_name (nombre visible del canal).
```
text:"frase exacta"
user_name:canalpublico
user_screen_name:"Canal Público de Noticias"
```
Recuerda que: Las consultas booleanas o los parámetros de sintaxis de Lucene siempre deben utilizarse dentro del parámetro q= en la estructura de la URL de llamada a la API. Los elementos dentro de q= constituyen toda la consulta que se adjunta a la llamada a la API.

Ejemplos útiles de agrupación de elementos de búsqueda

(...) Usa paréntesis para agrupar cláusulas y formar subconsultas.

(cocacola OR pepsi) AND (campaña NOT crisis)

Ejemplos de consultas Lucene más utilizadas por nuestros clientes

Aquí tienes algunos ejemplos de consultas para ilustrar el uso de la sintaxis de Lucene en nuestra API de Telegram:

Buscar mensajes que contengan la palabra "tecnología":
```
tecnología
```
Buscar mensajes con la frase exacta "inteligencia artificial":
```
"inteligencia artificial"
```
Buscar mensajes con "cambio" en el texto del canal con handle noticias (t.me/noticias):
```
user_name:noticias AND text:cambio
```
Buscar mensajes que mencionen "economía" pero no "recesión":
```
economía NOT recesión
```

Más Información

Para más detalles, consulta el manual completo de sintaxis de Lucene (aquí), que es la base de nuestro motor de búsqueda.

Conclusión y más Información

Usar la sintaxis de consultas de Lucene con la API de Telegram de TrawlingWeb te permite crear búsquedas precisas y complejas, asegurando que recuperes los datos más relevantes. Para una comprensión más completa de la sintaxis de consultas de Lucene, consulta la documentación oficial de Lucene.

Si tienes alguna pregunta o necesitas más asistencia, por favor contacta a nuestro equipo de soporte.

Contacto

Si tienes alguna pregunta, necesitas asistencia, contratar o ampliar tus servicios por favor contacta con nosotros.

SAT (Soporte Técnico):

SAC (Soporte administrativo):

Correo SAC

Sales (Soporte ventas):

Correo Ventas