2GIS API

2GIS API for places, contacts and reviews

2GIS businesses in 206 cities with phones, hours and ratings, and every written review with the owner's reply, as JSON. Send a place name, get its reviews. No 2GIS subscription.

  • No card needed
  • Failed calls are free
  • Pack credits never expire
Place
Endpoint
curl "https://api.toolzerhub.com/v1/2gis/search?city=dubai&query=%25Arabica&page_size=5" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
200 OK
Real response, 21 Oct 2026
{
  "data": {
    "query": "%Arabica",
    "city": "dubai",
    "results": [
      {
        "id": "70000001023366957",
        "name": "%Arabica, coffee shop",
        "address": {
          "street_address": "Dubai Mall, 3, Mohammed Bin Rashid Boulevard",
          "city": "Dubai"
        },
        "primary_rubric": "Coffee shop",
        "rating": 4.5,
        "review_count": 133,
        "latitude": 25.197085,
        "longitude": 55.278886
      },
      {
        "id": "70000001033569146",
        "name": "%Arabica, coffee shop",
        "address": {
          "street_address": "Mall of the Emirates, 783, Sheikh Zayed road",
          "city": "Dubai"
        },
        "primary_rubric": "Coffee shop",
        "rating": 5,
        "review_count": 8,
        "latitude": 25.118708,
        "longitude": 55.202611
      },
      {
        "id": "70000001028370041",
        "name": "%Arabica, coffee shop",
        "address": {
          "street_address": "City Walk Building 4B, 4B, Happiness street",
          "city": "Dubai"
        },
        "primary_rubric": "Coffee shop",
        "rating": 4.5,
        "review_count": 132,
        "latitude": 25.20446,
        "longitude": 55.26338
      }
    ],
    "count": 5,
    "total": 31
  }
}

Up to 3 rows shown, trimmed to the main fields; other branches of a chain come back too.

1
1 credit per call
99.4%
finished without a server error
0.5 s
median response time
4
2GIS endpoints

From our request logs, last 30 days to 21 Oct 2026.

Response

What comes back

Field names and types read off the real responses in the demo above.

  • Search places/v1/2gis/search8 fields
    • idstring"70000001023366957"
    • namestring"%Arabica, coffee shop"
    • addressobject{ street_address, city }
    • primary_rubricstring"Coffee shop"
    • ratingnumber4.5
    • review_countnumber133
    • latitudenumber25.197
    • longitudenumber55.279
  • Place details/v1/2gis/place11 fields
    • idstring"70000001023366957"
    • namestring"%Arabica, coffee shop"
    • urlstring"https://2gis.ru/dubai/f…"
    • addressobject{ street_address, address_comment }
    • primary_rubricstring"Coffee shop"
    • contactsobject{ phones, websites }
    • scheduleobject{ Fri, Mon }
    • ratingnumber4.5
    • review_countnumber133
    + 2 more
  • Place reviews/v1/2gis/reviews5 fields
    • idstring"304648471"
    • ratingnumber5
    • textstring"Bahut hi shandar kaise …"
    • date_createdstring"2026-10-10T02:22:29.591…"
    • providerstring"2gis"

Use cases

What people build with it

  • 01Export every review of a businessSearch placesPlace reviews
  • 02Build a lead list with phones and websitesSearch placesPlace details
  • 03Track ratings across a chain's branchesSearch placesPlace reviews

How it works

From key to JSON

  1. 01x-api-key••••••••••Get a key100 free credits a month, no card
  2. 02GET/v1/2gis/searchSend a requestAny HTTP client, no SDK needed
  3. 03{ data, status }200Get JSONFailed calls cost nothing

Pricing

What it costs

Every endpoint on this page costs 1 credit per call. Failed calls cost nothing.

  • Free$0every month
    • 100 credits a month
    • No card needed
  • 10K pack$19one time
    • 10,000 credits
    • Never expire
    • $1.90 per 1,000
  • Starter$29a month
    • 20,000 credits a month
    • Cancel anytime
    • $1.45 per 1,000

Per 1,000 credits

  • 10K pack$1.90
  • Starter$1.45
  • Growth$1.32
  • Scale$1.21
  • Business$0.99
  • Customfrom $0.99

Plans renew monthly and cancel anytime. Custom plans start at 1M+ credits. Full pricing

Compare

Why not build it yourself

Three ways to get 2GIS data into your app.

CompareToolzer Hub2GIS Places APIYour own scraper
SetupOne API keySubscription, monthly limitsProxies, sessions, retries
When 2GIS changesWe fix it2GIS keeps it workingYou fix the parser
Cost to start100 free credits a monthFrom 6,700 RUB a monthProxies and your time

Official API access rules: 2GIS: Places API pricing (opens in new tab)

FAQ

Questions

Is this the official 2GIS API?
No. Toolzer Hub is not affiliated with 2GIS. Ours returns the written reviews with owner replies, 50 a call, plus search and contacts, with one key and no subscription.
What does the official 2GIS API allow?
2GIS's Places API documents review statistics for a place, ratings and counts, not the review text. Keys are sold by monthly request limit in rubles, from 6,700 RUB for 10,000 requests; a demo key lasts one month.
What data does it return?
Search places in a city, Place details, Place reviews, as JSON.
What does it cost?
1 credit per call. New workspaces get 100 credits a month at no cost; plans work out to $0.99 to $1.45 per 1,000 credits. Failed calls are not charged.

Try the 2GIS API free

Every new workspace gets 100 credits a month. Buy credits only when you need more.

Not affiliated with 2GIS.