2gis.ae API2gis.ae ↗
Access UAE business listings, contacts, reviews, photos, menus, and categories from 2GIS.ae via 11 structured REST endpoints.
curl -X GET 'https://api.parse.bot/scraper/a33a4849-01d7-4cc2-925b-ba10d63e461b/search_companies?page=1&limit=3&query=restaurants' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for companies/businesses by keyword. Returns a paginated list of matches with address, contact info, reviews summary, schedule, and location data.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Number of results per page. |
| query | string | Search keyword (e.g. 'restaurants', 'hotels dubai') |
| filters | string | JSON string of additional filters (e.g. '{"work_time": "now"}') |
{
"type": "object",
"fields": {
"meta": "object containing api_version, code, and issue_date",
"result": "object containing items array of company summaries and total count"
},
"sample": {
"data": {
"meta": {
"code": 200,
"issue_date": "20260514",
"api_version": "3.0.20462"
},
"result": {
"items": [
{
"id": "70000001019627575",
"name": "Najmat Lahore, restaurant",
"type": "branch",
"point": {
"lat": 25.355036,
"lon": 55.382158
},
"address_name": "Al Saud Building, 50, Al Marija street"
}
],
"total": 24198
}
},
"status": "success"
}
}About the 2gis.ae API
The 2GIS UAE API provides access to 11 endpoints covering the full 2GIS.ae business directory for the UAE, returning structured data on company profiles, contacts, reviews, photos, menus, and geographic categories. The search_companies endpoint accepts keyword queries with optional filters like {"work_time": "now"} and returns paginated results including addresses, schedules, ratings, and contact summaries. Organization-level data can be expanded to individual branches using get_company_branches.
Search and Company Data
The search_companies endpoint accepts a query string (e.g. 'hotels dubai') plus optional filters as a JSON string, page, and limit for pagination. Results come back as a result.items array of company summaries including address, contact info, review rating, opening schedule, and geographic coordinates. To retrieve the full profile for a specific listing, pass its ID to get_company_details, which returns attributes, photos availability flags, rating breakdowns, and the org.id needed for branch lookups.
Contacts, Reviews, and Media
get_company_contacts returns structured contact groups with typed entries for phone numbers, email addresses, websites, and social media handles — all keyed to a company_id. Reviews are available through get_company_reviews, which returns an array of objects containing id, rating, text, user info, and timestamps. Pagination uses a cursor pattern: pass the date_created value of the last review as offset_date to fetch the next page, and follow the meta.next_link field.
Photos are split between two endpoints. get_company_photos returns all company images with photo URLs, media_type, album metadata (id, name, count), and a pagination token. get_company_menu scopes the same photo structure to the price_list_image album specifically, making it straightforward to retrieve menu or price-list images separately from general photos.
Categories and Discovery
browse_categories returns the 2GIS category tree. Without a parent_id it returns top-level metarubric entries with icons and tags; supply a parent_id to drill into subcategories. Once you have a rubric ID, search_by_category lists all companies in that category with the same paginated structure as search_companies. get_featured_places returns curated popular categories for the UAE region with no required inputs. list_cities returns all available regions on 2GIS with their IDs and names, useful for scoping subsequent queries.
- Build a UAE restaurant finder that queries
search_by_categorywith the Cafe/Restaurants rubric ID and displays menus fromget_company_menu. - Aggregate contact details for UAE businesses in a specific industry by combining
search_companiesresults withget_company_contacts. - Monitor business reputation by collecting review text, ratings, and dates from
get_company_reviewsacross multiple company IDs. - Map all branches of a UAE retail chain by fetching branch addresses and coordinates via
get_company_branchesusing the organization'sorg.id. - Populate a local business directory with structured opening hours, phone numbers, and photos pulled from
get_company_detailsandget_company_photos. - Discover high-traffic business categories in the UAE using
get_featured_placesand drill into listings withsearch_by_category. - Filter businesses currently open by passing
{"work_time": "now"}in thefiltersparameter ofsearch_companies.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does 2GIS offer an official developer API?+
How does pagination work for reviews in `get_company_reviews`?+
meta.next_link field. To fetch the next page, pass the date_created value of the last review on the current page as the offset_date parameter in your next request. This approach handles cases where new reviews are added between requests more reliably than offset pagination.Does the API return geocoordinates or routing data for companies?+
search_companies and branch records from get_company_branches include location data. The API does not currently expose turn-by-turn routing, distance-matrix calculations, or isochrone data. You can fork this API on Parse and revise it to add a routing or geocoding endpoint if that coverage is needed.Are there limitations on geographic coverage — does this cover all UAE cities?+
list_cities returns all regions indexed on 2GIS for the UAE. Coverage depth varies by city; major cities like Dubai, Abu Dhabi, and Sharjah have dense listings while smaller emirates may have fewer entries. The API does not cover 2GIS data outside the UAE (e.g. Russia, Kazakhstan, or other markets where 2GIS operates). You can fork it on Parse and revise it to target a different regional 2GIS domain if needed.Can I retrieve individual review responses from business owners?+
get_company_reviews endpoint returns review objects with user-submitted text, ratings, and timestamps. Owner replies to reviews are not currently included in the response. You can fork this API on Parse and revise it to add owner-response fields if your use case requires them.