---
title: "Analog Cities Query"
method: POST
path: "/api/v1/climate-velocity/analog-cities"
tags: ["Climate Velocity"]
---

# Analog Cities Query

`POST /api/v1/climate-velocity/analog-cities`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/climate-velocity/analog-cities`
- Auth: none declared

Find cities whose current climate matches this location's future.

Projects the location's climate forward using IPCC warming rates
and precipitation trends, then finds reference cities with the
most similar current climate. Includes similarity scores, distance,
and narrative.

Required fields: ``lat``, ``lon``
Optional fields: ``target_year`` (2030-2100, default 2050),
                 ``top_n`` (1-10, default 5)

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

## Query parameters

- `x_api_key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)