---
title: "Compara análises de veículos"
method: GET
path: "/v1/prices/compare/analytics"
tags: ["Preços", "Comparação"]
---

# Compara análises de veículos

`GET /v1/prices/compare/analytics`

## Request

- Base URL: `https://api.fipex.com.br`
- URL: `https://api.fipex.com.br/v1/prices/compare/analytics`
- Auth: none declared

Retorna análise detalhada de comparação para múltiplos veículos (1–10), incluindo
segmento de preço, depreciação, posição de mercado e código FIPE.

Mesma sintaxe de `vehicle_specs` que `/v1/prices/compare`.
Ao contrário de `/v1/prices/compare`, retorna 200 com array vazio se nenhuma
especificação produzir resultado (não retorna 400 por count mismatch).

Resultados ordenados por `model_slug, fuel_acronym, year NULLS FIRST`.

## Query parameters

- `vehicle_specs` string, required

## Response `200`

Análise de comparação obtida com sucesso (pode ser array vazio).

- CompareVehicleAnalyticsResponse
  - `data` VehicleComparisonAnalytics[], required
    - `price_id` string, uuid
    - `model_id` string, uuid
    - `model_name` string
    - `model_slug` string
    - `make_id` string, uuid
    - `make_name` string
    - `make_slug` string
    - `fuel_id` string, uuid
    - `fuel_name` string
    - `fuel_acronym` string
    - `type_id` string, uuid
    - `type_name` string
    - `year` integer, nullable: Ano do modelo; null para veículos zero km.
    - `price_cents` integer: Preço atual em centavos.
    - `price_formatted` string: Preço atual formatado.
    - `price_segment` 'PRICE_SEGMENT_UNSPECIFIED' | 'ECONOMY' | 'MID_RANGE' | 'PREMIUM' | 'LUXURY' | 'ULTRA_LUXURY': Segmento de preço do veículo conforme mv_price_segments.
    - `segment_threshold_economy` integer
    - `segment_threshold_mid` integer
    - `segment_threshold_premium` integer
    - `segment_threshold_luxury` integer
    - `age_years` integer, nullable
    - `new_price_cents` integer, nullable
    - `new_price_formatted` string, nullable
    - `value_retention_pct` number, float, nullable
    - `annual_depreciation_rate` number, float, nullable
    - `retention_rank` integer, nullable
    - `avg_retention_for_age` number, float, nullable
    - `retention_vs_avg` number, float, nullable
    - `price_percentile` number, float, nullable
    - `type_avg_price_cents` integer
    - `type_avg_price_formatted` string
    - `price_vs_type_avg_pct` number, float, nullable
    - `fipe_code` string: Código FIPE público, ex: "811049-7".
  - `pagination` Pagination, required
    - `total` integer, required: Número total de itens.
    - `limit` integer, required: Itens por página.
    - `page` integer, required: Número da página atual.
    - `pages` integer, required: Número total de páginas (mínimo 1, mesmo quando total=0).

## Other responses

- `400`: Erro de validação (400). Usado para TODOS os erros de validação — não há 422.
- `500`: Erro interno do servidor (500).

---

[API](https://skmtc.dev/fipex/apis/api-fipex.md) · [All operations](https://skmtc.dev/fipex/apis/api-fipex/llms.txt) · [OpenAPI document](https://skmtc.dev/fipex/apis/api-fipex/revisions/800eab7da73d?raw)