Search Lite y Summary Lite: nuevos endpoints para datos básicos de activos
Un repaso a dos nuevos endpoints — Search Lite y Summary Lite — diseñados en torno a conjuntos de campos fijos y más ligeros.
Hay dos endpoints nuevos en la API de FinImpulse: Search Lite y Summary Lite, además de los endpoints existentes Search y Summary. Ambos devuelven un conjunto de campos fijo y más reducido en comparación con sus equivalentes estándar y permiten acotar aún más la respuesta para incluir únicamente los campos que necesita una solicitud determinada.
Este artículo repasa cómo funcionan los dos endpoints, cómo se comparan con Search y Summary y en qué casos encaja mejor cada uno en una integración típica.
Search vs. Search Lite y Summary vs. Summary Lite
Los endpoints existentes Search y Summary son amplios y completos.
- Search devuelve más de 65 campos para consultas multiactivo, que abarcan clasificación, detalles de la bolsa, precios, indicadores técnicos, dividendos, valor de mercado, rentabilidad y datos de crecimiento.
- Summary devuelve más de 235 campos para un único símbolo, que cubren identificación, dirección, clasificación por sector e industria, indicadores de riesgo de gobernanza, precios, valoración, propiedad, cobertura de analistas y campos específicos de fondos.
Search Lite y Summary Lite son alternativas más ligeras a estos dos endpoints: cada uno devuelve un conjunto de campos fijo y más reducido, tiene un coste menor (consulte los precios de la API) y permite personalizar aún más la respuesta mediante un parámetro select_identifiers que controla cuáles de los campos disponibles se devuelven.
Es importante señalar que los endpoints estándar y Lite son independientes entre sí y no están relacionados en cuanto a su implementación: cada uno tiene su propio conjunto fijo de campos, su propio esquema de respuesta y su propio precio. Los endpoints Lite no devuelven un subconjunto de todos los campos disponibles en Search o Summary — cada endpoint Lite tiene su propio conjunto fijo de campos, más reducido.
Endpoint Search Lite
Search Lite devuelve resultados de búsqueda multiactivo en acciones, ETF y fondos de inversión. Utiliza los mismos parámetros de búsqueda y filtrado que el endpoint Search estándar: búsqueda de texto libre, filtrado por tipo de cotización, listas de símbolos, expresiones de filtrado, ordenación y paginación. La respuesta contiene 26 campos: datos de identificación, precios actuales y métricas de rendimiento de uso frecuente.
Esto hace que Search Lite encaje en interfaces de búsqueda y componentes de autocompletado, donde una consulta debe devolver rápidamente muchos activos coincidentes y solo se necesitan los datos básicos de identificación y precios para mostrar los resultados. También es una opción razonable por defecto para cualquier integración que realice consultas de búsqueda frecuentes y no requiera los fundamentales más amplios, los indicadores técnicos ni los datos de valoración disponibles a través del endpoint Search estándar.
Endpoint Summary Lite
Summary Lite obtiene una instantánea de datos específica para el símbolo de un activo concreto mediante el esquema unificado — los campos que no se aplican a un tipo de activo determinado se devuelven como null o como cadena vacía (“”). El endpoint recibe un único parámetro obligatorio, symbol, y la respuesta incluye 27 campos que cubren identificación, precios actuales, datos de dividendos y un pequeño conjunto de métricas de mercado y valoración.
Summary Lite resulta idóneo para vistas compactas de detalle de activos, widgets de panel o cualquier flujo de trabajo que necesite un conjunto pequeño y predecible de campos de precios y valoración para un único símbolo sin recuperar la respuesta completa de Summary. Es una opción razonable siempre que una integración muestre solo unas pocas métricas por activo y no requiera los principales datos financieros, los datos de propiedad, la cobertura de analistas ni el historial de rentabilidad de los fondos.
Parámetro Select Identifiers
Tanto Search Lite como Summary Lite aceptan un parámetro select_identifiers opcional. El parámetro acepta una lista de nombres de campos y limita la respuesta únicamente a esos campos.
Ejemplo de código — un select_identifiers para Summary Lite:
"select_identifiers": [
"average_volume",
"average_volume_10days",
"market_cap",
"fifty_two_week_low",
"fifty_two_week_high",
"current_price",
"current_price_usd",
"regular_market_price_usd",
"pre_market_price_usd",
"post_market_price_usd",
"valuation_measures_forward_pe_ratio",
"valuation_measures_pb_ratio",
"valuation_measures_pe_ratio",
"valuation_measures_ps_ratio"
]
La selección se limita a los campos disponibles para cada endpoint. La lista completa de campos disponibles de Search Lite y Summary Lite puede consultarse en la documentación de cada uno.
Hay algunos puntos importantes que conviene tener en cuenta sobre el comportamiento del parámetro:
- Si el parámetro no se proporciona o se establece en null, se devuelve el conjunto completo de campos Lite.
- Los campos
symbolylogose incluyen siempre en la respuesta, independientemente de los campos que se especifiquen.
Por lo tanto, el parámetro select_identifiers resulta especialmente valioso a gran escala. Para integraciones como exportaciones masivas, dashboards de monitorización o extracciones de datos programadas que solo necesitan unos pocos campos específicos por activo, evita la sobrecarga de recuperar la respuesta Lite completa en cada solicitud.
En resumen
Los nuevos endpoints Lite, junto con el parámetro select_identifiers, permiten un mayor control sobre la cantidad de datos que devuelve cada solicitud — y, por extensión, sobre el tamaño de la respuesta y el coste a gran escala.
Para los equipos que crean interfaces de búsqueda, vistas de detalle compactas o extracciones de datos de gran volumen, esto facilita ajustar la respuesta de la API a lo que realmente muestra una función concreta, en lugar de tener que lidiar con un payload fijo y más amplio.
