geokodv2.4api · ok
docsGet a key

geocoding api · v2.4

Address → coordinates in 42 ms

Geocoding, reverse geocoding, routes and address suggestions across Russia and the CIS. One key, one request, the answer is JSON. Free up to 10 000 requests a month.

  • 99.99%uptime over a year
  • 42 msmedian response
  • 0 ₽up to 10 000 requests

Sandbox

Try it without a key

Type an address — the answer comes as if from the real API: coordinates, precision, a normalised address. The dot on the map goes there too.

// the response appears here — press «Send» or pick an address
55.7599, 37.6101
  • latency
  • cost
  • precision
  • free requests left10 000

The sandbox answers with pre-recorded data: no key needed, the quota isn't spent.

Endpoints

Six methods, one key

Everything delivery, maps and logistics need. One response format, one authorisation, the same documentation.

  • GET/v2/geocode
    «Tverskaya 7, msk»55.7599, 37.6101

    Forward geocoding

    An address string in any form — with typos, abbreviations, no postcode — turns into building coordinates and a normalised address.

    p50 · 42 ms
  • GET/v2/reverse

    Reverse geocoding

    Coordinates → the nearest address, district, postcode and object type.

    p50 · 39 ms
  • POST/v2/route
    7.4 km · 18 min

    Routes

    Car, walking, bike: geometry, distance, time with traffic.

    p50 · 110 ms
  • GET/v2/suggest

    Address suggestions

    Autocomplete from the first letters for delivery and sign-up forms.

    p50 · 24 ms
  • POST/v2/matrix

    Distance matrix

    Up to 100 × 100 points in one request — for logistics and picking the nearest warehouse.

    p50 · 180 ms
  • POST/v2/batch

    Batch processing

    Upload a file with a million addresses — we return a geocoded CSV.

    ≈ 12 min per 1 000 000

Pricing

Pay per request, not per seat

The first ten thousand requests a month are free — forever. After that the price per thousand drops with volume. Move the slider to your load.

Total per month
96 / mo

effectively 0,38 ₽ per 1 000 · 0,40 ₽ at the current tier

  • first 10 000 · free0 ₽
  • up to 1M · 0,40 ₽ / 1 00096 ₽
  • up to 10M · 0,25 ₽ / 1 000
  • over 10M · 0,12 ₽ / 1 000
0,00 0,20 0,40 1 k10 k100 k1 M10 M100 M
₽ per 1 000 requestsrequests per month →
  • No card up to 10 000
  • Invoice at the end of the month
  • Limits and alerts in the dashboard

Status

Lives in four regions

A request goes to the nearest region. The panel updates every second, the history covers 90 days, no retouching.

All systems operational

updated —:—:—
  • Moscow

    msk-1
    • uptime 30 d99.99%
    • p50 now
    • p99
  • Saint Petersburg

    spb-1
    • uptime 30 d99.98%
    • p50 now
    • p99
  • Frankfurt

    fra-1
    • uptime 30 d100%
    • p50 now
    • p99
  • Almaty

    ala-1
    • uptime 30 d99.97%
    • p50 now
    • p99

history90 days · 2 degradations · 0 outages

Comparison

Honestly against three others

Numbers from public price lists and our measurements as of September 2026. Click a row — we'll show how it looks in the API response.

    • AddrPro96.1%
    • MapOne97.2%
    • GeoCloud88.0%

    Measured on a control sample of 50 000 delivery addresses in 85 regions: the share of answers with «house» precision and an error under 30 metres.

    "precision": "house",
    "confidence": 0.98,
    "distance_m": 4
    • AddrPro120 ms
    • MapOne85 ms
    • GeoCloud210 ms

    Measured from Moscow over the last 30 days, p50 on the /geocode endpoint. The request goes to the nearest region automatically.

    "took_ms": 42,
    "region": "msk-1",
    "cached": false
    • AddrPro1.20 ₽
    • MapOne0.90 ₽
    • GeoCloud4.50 ₽

    The rate of the first paid tier. Cheaper with volume: from a million — 0.25 ₽, from ten — 0.12 ₽. We round in your favour.

    "billing": {
      "tier": "1m",
      "per_1000": 0.40
    }
    • AddrPro1 000
    • MapOne25 000*
    • GeoCloud0

    Ten thousand requests a month with no card and no branding. The asterisk at a competitor — the free quota only comes with showing their map.

    "quota": {
      "free": 10000,
      "used": 2, 
      "resets_at": "2026-10-01"
    }
    • AddrProno
    • MapOneup to 100k
    • GeoCloudno

    Upload a CSV — collect a CSV. A million addresses are processed in twelve minutes; the status can be polled or delivered by webhook.

    "job": "btch_91ka",
    "rows": 1000000,
    "eta_s": 720
    • AddrProyes
    • MapOneyes
    • GeoCloudno

    All processing regions and log storage are in data centres in Russia. No cross-border transfer, it's written into the contract.

    "storage": "ru",
    "log_retention_days": 30
    • AddrPro
    • MapOne99.5%
    • GeoCloud99.9%

    On all paid volumes. For every 0.1% below — we refund 10% of the monthly invoice, no tickets and no correspondence.

    "sla": 0.999,
    "credit_policy": "auto"

* — the competitor's free quota only applies when showing their map and logo.

Changelog

What changed

Every version with a date, tags and a list. Breaking changes are announced six months ahead and the old version is kept all that time.

  1. v2.4.0newperf

    Address suggestions ranked by geolocation

    • /suggest accepts lat/lon and ranks nearby addresses higher
    • The /suggest median dropped from 31 to 24 ms thanks to a new index
    • The postal_code field is now in every /geocode response
  2. v2.3.2fix

    Reverse geocoding fixes

    • /reverse on region borders returned the neighbouring district — fixed
    • Empty house in Kazan and Ufa responses
  3. v2.3.0new

    Distance matrix up to 100 × 100

    • /matrix computes up to 10 000 pairs in one request
    • Profiles car, walk, bike; traffic — for car by default
    • Webhooks for /batch: the status arrives on its own
  4. v2.0.0breaking

    The second version of the API

    • The /geocode response: results is an array, not an object; precision instead of kind
    • Keys like gk_live_… and gk_test_…; the old ones work until 1 December
    • A single error format with a code field
All versions

used by

SamokatDostavistaCitymobilLamodaCDEKWildberriesOzonYandex EatsBoxberryDelivery ClubCianAvito

Reviews

What those who've already integrated say

Unretouched: developers from delivery, logistics, taxi and e-commerce. The metrics are theirs, not ours.

  • @lena_builds
    Lena Guseva · Tech lead, food delivery
    Migrated from a homemade geocoder in one sprint. Building-level accuracy went up, and couriers stopped calling «where is this». The TypeScript SDK is typed down to the last field.
    • Next.js
    • TypeScript

    −70% courier calls

  • @mzhukov
    Maxim Zhukov · Backend, logistics
    The 100 × 100 matrix answers faster than our database can write the result. Started a million-address batch in the evening — the CSV was there in the morning.
    • Go
    • PostgreSQL

    1 000 000 addresses in 12 min

  • @a.petrova
    Anya Petrova · Frontend, e-commerce
    Address suggestions in the order form — twenty lines of code. Customers finish typing the address three times less often, because it fills itself in.
    • React
    • Vite

    +11% completed orders

  • @d_orlov
    Dima Orlov · CTO, regional taxi
    The Almaty region appeared when we were expanding there — asked support, a month later it was up. Not a single outage in a year, the status panel is honest.
    • Python
    • FastAPI

    99.99% over 12 months

  • @katya.ops
    Katya Melnik · DevOps
    Limits, alerts and invoices in one dashboard. When traffic grew sixfold during a sale, nothing fell over and nobody called — the invoice just got bigger.
    • Kubernetes
    • Grafana

    ×6 traffic with no degradation

  • @sergey_v
    Sergey Volkov · Independent developer
    Ten thousand free requests are plenty for a pet project. Got the key in half a minute, no card asked. The docs have examples in four languages.
    • Node.js

    0 ₽ for eight months now

GET /v2/key

A key in 30 seconds

Your email — and the key is already in the response. No card, no call from a manager, no «we'll get back to you». Ten thousand requests a month free.

  • No card
  • 10 000 requests free
  • Revoke in one click