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 * y notaciones de ticker de proveedores; consulta la sección «Soporte de notación de tickers» más abajo)

• 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 los países sobre los que trata el artículo, usando códigos de país ISO 3166-1 alpha-2 (p. ej., US, GB, DE, JP, CN, FR, CA, AU, IN, BR, etc.). Corresponde al campo countries del artículo, no al país del editor, al domicilio de la empresa ni al mercado de cotización.

• 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 notación de tickers

✨ Nuevo: No necesitas adivinar el formato correcto del ticker: las notaciones más comunes de los proveedores se reconocen automáticamente.

Cada plataforma escribe los tickers de forma diferente, por lo que la API entiende de serie las notaciones más comunes:

Las mismas notaciones funcionan en el parámetro estructurado tickers de la solicitud (p. ej., tickers=["000660.KS", "KRX:005930"]).

Conviene saber:

• Las notaciones cualificadas con bolsa fijan un ticker a su mercado y desambiguan símbolos que colisionan: ticker:TM a secas coincide con cualquier empresa con el símbolo TM en cualquier bolsa, mientras que ticker:TM.US apunta específicamente a la cotización estadounidense.
• El ticker y la bolsa siempre se refieren a la misma empresa: una coincidencia nunca se forma a partir de dos empresas distintas.
• Los tickers con clase de acciones de EE. UU. como ticker:BRK.B, ticker:PBR.A o ticker:REI.UN coinciden exactamente como se escriben: las letras de clase nunca se confunden con sufijos de bolsa.
• Los valores de exchange: también son flexibles: nombres comunes de bolsas como exchange:KOSDAQ o exchange:NASDAQ funcionan junto con los códigos MIC listados más arriba.
• Los sufijos o prefijos desconocidos (p. ej., ticker:FOO.XX) coinciden literalmente.
• La notación con espacios de Bloomberg (000660 KS Equity) no está admitida; usa una de las notaciones anteriores.

Ejemplos:

query=ticker:000660.KR
query=ticker:KRX:000660 AND earnings
query=(ticker:005930.KS OR ticker:000660.KS) -source:finance.yahoo.com
query=ticker:NVDA.US AND category:technology

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 artículos sobre un país específico:

query=country:US

Encontrar noticias sobre Alemania, 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 centradas en EE. UU. que involucren a empresas cotizadas en NASDAQ, excluyendo el contenido de criptomonedas?

query=country:US exchange:XNAS -crypto

Ejemplo: ¿Quieres noticias sobre resultados centradas en Alemania, Francia o Reino Unido?

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.