Examples

Find a category by name

Step 1. Retrieve the id of a region:

https://catalog.api.2gis.com/2.0/region/search?q=Moscow&key=YOUR_KEY

Step 2. Find a category:

https://catalog.api.2gis.com/2.0/catalog/rubric/search?q=cafe&region_id=32&key=YOUR_KEY

---

Get the list of categories at a region

Step 1. Retrieve the id of a region:

https://catalog.api.2gis.com/2.0/region/search?q=Moscow&key=YOUR_KEY

Step 2. Get the list of categories:

https://catalog.api.2gis.com/2.0/catalog/rubric/list?region_id=32&key=YOUR_KEY

---

Retrieve the list of child categories

Step 1. Get the id of a region:

https://catalog.api.2gis.com/2.0/region/search?q=Moscow&key=YOUR_KEY

Step 2. Retrieve the list of child categories.

Option 1.

Getting the list of common categories:

https://catalog.api.2gis.com/2.0/catalog/rubric/list?region_id=32&key=YOUR_KEY

Getting the list of child categories

https://catalog.api.2gis.com/2.0/catalog/rubric/list?parent_id=2&region_id=32&key=YOUR_KEY+

Option 2. Retrieve child categories by adding the fields=items.rubrics parameter to the request for list of common categories.

https://catalog.api.2gis.com/2.0/catalog/rubric/list?region_id=32&fields=items.rubrics&key=YOUR_KEY