# 2GIS Weather Forecast API

> 2GIS weather for any coordinates: current conditions, 12-hour and 7-day forecasts

- Vendor: `2gisweatherforecastapi` · version 1.0 · category Weather · tags 2gis api, weather forecast api, hourly forecast api, daily forecast api, current weather api, free weather api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/2gisweatherforecastapi
- This document: https://apiclay.com/docs/2gisweatherforecastapi.md
- OpenAPI 3.1: https://apiclay.com/api/2gisweatherforecastapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `2gisweatherforecastapi`
- Updated: 2026-11-18

## About

## 2GIS Weather Forecast API

The weather feed behind the 2GIS maps app: for any latitude and longitude, the current air and feels-like temperature, wind speed and direction, pressure, a plain-language description and day or night flag, then 12 hourly temperatures with condition icons and 7 daily minimum and maximum temperatures (air and feels-like), with the place's UTC offset.

Data comes from **2gis.ae** (https://2gis.ae). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/forecast?lat=40.71&amp;lon=-74.0&amp;locale=en_US`.

### Routes

#### GET `/forecast` - Forecast
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lat | query | number | yes | Latitude, e.g. `40.71`. |
| lon | query | number | yes | Longitude, e.g. `-74.0`. |
| locale | query | string | no | Text language, e.g. `en_US` or `en_AE` for English (default Russian). |

Returns: `current` (`temperature.air`, `temperature.feels`, `wind.speed` in m/s, `wind.direction`, `pressure.value` in mmHg, `weather_description`, `short_weather_description`, `time_of_day`, `icon`), `forecast_hourly` (12 items: `date` Unix seconds, `temperature.air`, `icon`), `forecast_daily` (7 items: `date`, `temperature.min` and `.max` with `air` and `feels`, `icon`), `tz_offset`.

### Caveats

- Temperatures are in °C. `forecast_daily` is not sorted; order it by `date`. Forecasts come from 2GIS's weather provider and are for general guidance.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by 2gis.ae.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /forecast — Forecast
- Gateway: `GET https://api.apiclay.com/v1/api/2gisweatherforecastapi/forecast`
- Public query params: `lat` (number, required), `lon` (number, required), `locale` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/2gisweatherforecastapi/forecast?lat=<lat>&lon=<lon>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
