Endpoint de Analíticas de Cotizaciones

Este endpoint proporciona analíticas detalladas sobre las cotizaciones de seguros para una compañía específica durante un período de tiempo determinado.

URL del Endpoint

https://guatemala-lambdas.eprezto.com/prod/report-analytics

Método HTTP

GET

Parámetros de Consulta (Query String)

Parámetro	Descripción	Requerido
`company`	Valor encriptado proporcionado por Eprezto.	Sí
`from`	Fecha de inicio del período de análisis en formato ISO 8601 (YYYY-MM-DD). Si se especifica `from`, también se debe especificar `to`.	No
`to`	Fecha de fin del período de análisis en formato ISO 8601 (YYYY-MM-DD). Si se especifica `to`, también se debe especificar `from`.	No

Ejemplo de URL con Parámetros

https://guatemala-lambdas.eprezto.com/prod/report-analytics?company=GFp3ob3t8aKgysezDZ4r9&from=2024-01-01&to=2024-02-01

Ejemplo de Respuesta

{
  "positionRanked": 3,
  "company": "seguros-eprezto",
  "analysisFrom": "2023-06-08T12:31:32.134Z",
  "analysisTo": "2024-03-14T17:21:21.473Z",
  "averagePremium": 5177,
  "averagePremiumLastMonth": 5479.5,
  "maxPremium": 28807.39,
  "maxPremiumLastMonth": 17617.14,
  "minPremium": 3057.6,
  "minPremiumLastMonth": 3057.6,
  "mostPopularVehicle": "HYUNDAI ACCENT",
  "mostPopularVehicleLastMonth": "TOYOTA COROLLA 4WD DLX",
  "selectedQuotations": 36,
  "selectedQuotationsLastMonth": 1,
  "totalSelectedQuotations": 121,
  "totalSelectedQuotationsLastMonth": 6,
  "vehicleMaxPremium": "MERCEDES BENZ SPRINTER 2018",
  "vehicleMaxPremiumLastMonth": "NISSAN FRONTIER 2022",
  "vehicleMinPremium": "HONDA ACCORD 2012",
  "vehicleMinPremiumLastMonth": "MAZDA MAZDA3 I SPORT 2016",
  "timesQuotationCardAppeared": 1053,
  "premiumQuoted": 4886730.97
}

Descripción de los Campos de Respuesta

Campo	Descripción
`positionRanked`	Indica la prioridad de aparición de una aseguradora en los resultados, donde 1 es máxima visibilidad y 3, la mínima.
`company`	Nombre de la compañía de seguros.
`analysisFrom`	Fecha de inicio del período de análisis.
`analysisTo`	Fecha de fin del período de análisis.
`averagePremium`	Prima promedio cotizada con esa aseguradora durante el período de análisis.
`averagePremiumLastMonth`	Prima promedio cotizada en los últimos 30 días.
`premiumQuoted`	Valor total de todas las primas cotizadas con la aseguradora.
`maxPremium`	Prima más alta cotizada por la aseguradora en el período de análisis.
`maxPremiumLastMonth`	Prima más alta cotizada en el último mes.
`minPremium`	Prima más económica cotizada por la aseguradora durante el período de análisis.
`minPremiumLastMonth`	Prima más económica cotizada en el último mes.
`mostPopularVehicle`	Vehículo con el mayor número de cotizaciones en el período de análisis.
`mostPopularVehicleLastMonth`	Vehículo con el mayor número de cotizaciones en el último mes.
`selectedQuotations`	Cantidad de veces que se seleccionó una póliza de esa aseguradora durante el período de análisis.
`selectedQuotationsLastMonth`	Cantidad de veces que se seleccionó una póliza en el último mes.
`timesQuotationCardAppeared`	Cantidad de veces que la tarjeta de esa compañía se mostró al cliente.
`totalSelectedQuotations`	Cantidad total de veces que se seleccionó una póliza (incluye todas las compañías).
`totalSelectedQuotationsLastMonth`	Cantidad total de veces que se seleccionó una póliza en los últimos 30 días (incluye todas las compañías).
`vehicleMaxPremium`	Marca, modelo y año del vehículo con la cotización más cara durante el período de análisis.
`vehicleMaxPremiumLastMonth`	Marca, modelo y año del vehículo con la cotización más cara en el último mes.
`vehicleMinPremium`	Marca, modelo y año del vehículo con la cotización más económica durante el período de análisis.
`vehicleMinPremiumLastMonth`	Marca, modelo y año del vehículo con la cotización más económica en el último mes.
`topQuotedCategories *`	Resumen de las categorías de vehículos más cotizadas, incluyendo el tipo de vehículo, el número total de cotizaciones recibidas por cada categoría, y el porcentaje que representa del total de cotizaciones.

*El análisis reflejado en este campo se basa en datos recopilados a partir del 19 de marzo de 2023, por lo que las cotizaciones anteriores a esta fecha no se incluyen en el resumen presentado.

Ejemplo de Uso

cURL
JavaScript
Python

curl --request GET \
--url 'https://guatemala-lambdas.eprezto.com/prod/report-analytics?company=GFp3ob3t8aKgysezDZ4r9&from=2024-01-01&to=2024-02-01'

const axios = require("axios");

const company = "ENCRYPTED_COMPANY_VALUE";
const from = "2024-01-01";
const to = "2024-02-01";

axios
  .get("https://guatemala-lambdas.eprezto.com/prod/report-analytics", {
    params: {
      company: company,
      from: from,
      to: to,
    },
  })
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error);
  });

import requests

company = 'ENCRYPTED_COMPANY_VALUE'
from_date = '2024-01-01'
to_date = '2024-02-01'

params = {
    'company': company,
    'from': from_date,
    'to': to_date
}

response = requests.get('https://guatemala-lambdas.eprezto.com/prod/report-analytics', params=params)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f'Error: {response.status_code}')

Este endpoint proporciona una visión detallada de las analíticas de cotizaciones de seguros para una compañía específica durante un período determinado. Puedes utilizar los datos devueltos para generar informes, visualizaciones y obtener información valiosa sobre el rendimiento de las cotizaciones de seguros.

Endpoint de Analíticas de Cotizaciones

URL del Endpoint​

Método HTTP​

Parámetros de Consulta (Query String)​

Ejemplo de URL con Parámetros​

Ejemplo de Respuesta​

Descripción de los Campos de Respuesta​

Ejemplo de Uso​