Creación de consultas avanzadas

Al trabajar con la API de finlight.me, tienes el poder de obtener exactamente los datos que necesitas mediante técnicas de creación de consultas avanzadas. Esta guía te explica métodos complejos de filtrado, ordenación y paginación para ayudarte a optimizar tu proceso de obtención de datos.

Accede rápidamente a la API y prueba tus consultas con nuestro Panel - Probador de API.

Idioma y cobertura multilingüe

finlight indexa noticias en muchos idiomas, pero cada solicitud se filtra a un idioma. El parámetro language tiene como valor predeterminado en, así que si no lo configuras recibes solo artículos en inglés: el contenido en cualquier otro idioma se excluye silenciosamente.

Importante: language tiene como valor predeterminado en. Una solicitud sin language devuelve solo resultados en inglés. Los artículos publicados en otros idiomas (por ejemplo, muchos medios en chino, zh) no se devuelven a menos que solicites explícitamente ese idioma.

Cómo funciona

• A nivel de artículo, coincidencia exacta. language filtra por el código ISO 639-1 de cada artículo como coincidencia exacta. language=en devuelve solo artículos en y nunca de, zh, etc.
• Un idioma por solicitud. language admite un único valor: no se admiten arrays/listas separadas por comas y no hay opción de "todos los idiomas". Para cubrir varios idiomas, envía una solicitud por idioma y combina los resultados.
• Las fuentes pueden ser multilingües. Una misma fuente puede publicar en más de un idioma; el filtro selecciona los artículos por su idioma, no por la fuente. Los artículos no ingleses de un medio solo aparecen cuando solicitas ese idioma.

Ejemplos

Predeterminado (solo inglés) — equivalente:

query=Alibaba
query=Alibaba&language=en

Cobertura en chino:

query=Alibaba&language=zh

Cubrir inglés + chino — dos solicitudes, luego combinar:

query=Alibaba&language=en
query=Alibaba&language=zh

Consejo: Usa códigos ISO 639-1 (en, de, fr, zh, …). El conjunto de fuentes predeterminado de finlight abarca muchos idiomas; el inglés es solo el filtro predeterminado, no el límite de la cobertura.

Filtrado por consulta

El parámetro query permite una lógica flexible basada en palabras clave y precisión a nivel de campo. Ahora puedes apuntar a campos específicos como ticker, exchange, isin, source, openfigi y más.

Uso básico de palabras clave

Palabra clave única:

query=Nvidia stock

Frase exacta: Encierra las frases entre comillas dobles para buscar coincidencias exactas.

query="Elon Musk"

Inclusión / Exclusión con operadores

Forzar inclusión (+) y exclusión (-):

Usa + para requerir/incluir y - para excluir términos o valores específicos de campo.

query=stock +market -google

Esto devolverá artículos que contengan "stock" y "market", pero excluirá los que mencionen "google".

Filtrado a nivel de campo

Nota: Esta es una potente función nueva que te permite filtrar resultados según campos específicos directamente dentro del parámetro query.

Ahora puedes consultar campos específicos directamente usando la sintaxis field:value también en el parámetro query. Esto permite consultas más precisas y complejas, lo que te permite filtrar resultados según atributos específicos como símbolos de ticker, bolsas, ISIN, fuentes y más.

✨ Nuevo: Usa el comodín * con los campos source, ticker y exchange para coincidir con todos los valores (p. ej., source:*, ticker:*, exchange:*).

Campos admitidos

• ticker (admite el comodín *)

• isin

• title

• summary

• content

• openfigi

• exchange (admite el comodín *)

  • Todas las bolsas son estándares MIC (códigos de identificación de mercado). Los códigos admitidos incluyen: ASEX, BVCA, BVMF, DSMD, HSTC, XSTC, MISX, NEOE, PFTS, ROCO, XADS, XAMM, XAMS, XASX, XBAH, XBEL, XBEY, XBKK, XBOG, XBOM, XBOT, XBRA, XBRU, XBSE, XBUD, XBUE, XBUL, XCAS, XCNQ, XCOL, XCSE, XCYS, XDAR, XDFM, XDHA, XDUS, XETR, XFKA, XFRA, XGHA, XHAM, XHEL, XHKG, XICE, XIDX, XIST, XJAM, XJSE, XKAR, XKAZ, XKLS, XKOR, XKUW, XLIM, XLIS, XLIT, XLJS, XLUS, XLUX, XMAL, XMAU, XMEX, XMIL, XMSW, XMUN, XNAI, XNAM, XNAS, XNGM, XNGO, XNSA, XNSE, XNYS, XASE, XOSL, XPAR, XPHS, XPRA, XRIS, XSAP, XSAU, XSES, XSCA, XSGO, XSHE, XSHG, XKRX, XSTU, XSWX, XTAE, XTAI, XTAL, XTSE, XTSX, XTUN, XUBS, XUGA, XWAR, XWBO, XZAG, XZIM, XSTO, OTCM, BMEX, XDUB, XJPX, BCXE, XPAE, XLON, XMUS, XNZE, XCAI, XBRV

• country

  • Filtra por país de la empresa usando códigos de país ISO 3166-1 alpha-2 (p. ej., US, GB, DE, JP, CN, FR, CA, AU, IN, BR, etc.)

• category

  • Filtra por categoría de artículo. Valores posibles: markets, economy, business, politics, geopolitics, regulation, technology, energy, commodities, crypto, health, climate, security

• source (admite el comodín *)

  • Ver todas las fuentes disponibles en la documentación de la API

Soporte de comodines

El comodín * te permite incluir explícitamente todas las fuentes, tickers o bolsas en tu consulta. Esto es particularmente útil cuando quieres asegurar una cobertura amplia o al combinarlo con otros filtros.

Ejemplos:

query=source:*

Devuelve artículos de todas las fuentes disponibles.

query=ticker:* country:US

Devuelve artículos sobre cualquier ticker de empresas de EE. UU.

query=exchange:* -crypto

Devuelve artículos de todas las bolsas, excluyendo el contenido de criptomonedas.

Ejemplos de filtros de campo

Pruébalo en el Probador de API para ver cómo funciona y crear fácilmente tus propias consultas complejas.

Filtrar por fuente exacta:

query=source:www.some-source.de

Excluir una fuente:

query=-source:www.some-source.de

Requerir un ticker específico y excluir alguna fuente:

query=ticker:AAPL -source:www.some-source.de

Encontrar resultados donde el contenido mencione "earnings" y la bolsa sea NASDAQ:

query=content:earnings exchange:nasdaq

Filtrar por empresas de un país específico:

query=country:US

Encontrar noticias sobre empresas alemanas, excluyendo Schulden:

query=country:DE -Schulden

Combinar filtrado por país y ticker:

query=country:US ticker:NVD

Combinar filtrado de campo con búsqueda general:

query="quarterly report" source:www.some-source.com -crypto

Operadores booleanos

Nota: Las palabras se unen por defecto con AND; no necesitas usar AND explícitamente a menos que quieras combinar con OR o NOT.

La lógica AND / OR / NOT es totalmente compatible:

query=stock AND google
query=amazon OR google
query=market AND NOT bitcoin

Usa paréntesis para agrupar: Combina expresiones lógicas para un filtrado avanzado.

query=("Elon Musk") AND (twitter OR tesla)

Combina con comodines para consultas potentes:

query=ticker:* AND (country:US OR country:GB) -crypto
query=source:* exchange:XNAS

💡 Consejos para usuarios avanzados

• Los filtros de campo admiten + y - para valores requeridos y excluidos.
• El comodín * se puede usar con los campos source, ticker y exchange para coincidir con todos los valores.
• Puedes combinar varios campos y palabras clave para consultas muy precisas.
• Los operadores booleanos como AND, OR y NOT no distinguen mayúsculas de minúsculas.
• Los paréntesis () ayudan a controlar la precedencia en consultas complejas.
• Usa comillas dobles " alrededor de frases de varias palabras para evitar coincidencias parciales.

Conclusión - Combínalo todo

Ejemplo: ¿Quieres noticias sobre Tesla (ticker:TSLA), de fuentes confiables, que no sean sobre cripto?

query=+ticker:TSLA -crypto AND (+source:www.bloomberg.com OR +source:www.reuters.com)

Ejemplo: ¿Quieres noticias sobre Tesla (ticker:TSLA) o Apple (ticker:AAPL) de Bloomberg?

query=source:www.bloomberg.com AND ticker:TSLA OR source:www.bloomberg.com AND ticker:APPL

Ejemplo: ¿Quieres noticias sobre empresas de EE. UU. que cotizan en NASDAQ, excluyendo el contenido de criptomonedas?

query=country:US exchange:XNAS -crypto

Ejemplo: ¿Quieres noticias sobre empresas tecnológicas europeas (Alemania, Francia o Reino Unido) con menciones de resultados?

query=earnings AND (country:DE OR country:FR OR country:GB)

Ejemplo: ¿Quieres todas las noticias relacionadas con tickers de todas las fuentes, excluyendo cripto?

query=ticker:* source:* -crypto

Pruébalo en el Probador de API para ver cómo funciona y crear fácilmente tus propias consultas complejas.

Campos de consulta del Raw WebSocket

El Raw WebSocket admite un subconjunto de filtros a nivel de campo adaptados a su modelo de datos simplificado. A diferencia del WebSocket enriquecido y la API REST, el Raw WebSocket no admite filtros de campo relacionados con ticker, bolsa o empresa.

Campos admitidos

• source - Filtra por el dominio de origen del artículo
• title - Filtra por el contenido del título del artículo
• summary - Filtra por el contenido del resumen del artículo

Ejemplos

Filtrar por contenido del título:

query=title:Nvidia

Combinar filtros de título y resumen:

query=summary:earnings +title:Tesla

Filtrar por fuente con exclusión de palabra clave:

query=source:www.reuters.com -crypto

Combinar varios filtros de campo con operadores booleanos:

query=title:Apple AND summary:revenue

Nota: Los operadores de consulta estándar (+, -, AND, OR, NOT, paréntesis y comillas dobles) funcionan todos con los filtros de campo del Raw WebSocket.

¿Necesitas ayuda?

Si alguna vez te sientes atascado, tienes una pregunta o ves margen de mejora, no dudes en ponerte en contacto. Esperamos saber de ti y apoyar tu éxito con la API de finlight.me.