Skip to main content
POST
/
api
/
twogis
/
places
/
search
/twogis/places/search
curl --request POST \
  --url https://api.anysite.io/api/twogis/places/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "query": "<string>",
  "count": 2,
  "timeout": 300,
  "region_id": "32",
  "point": "37.62,55.75",
  "radius": 20000,
  "rubric_id": "161",
  "sort": "relevance",
  "sort_point": "37.62,55.75",
  "has_photos": true,
  "open_now": true
}
'
[
  {
    "id": "<string>",
    "name": "<string>",
    "@type": "@twogis_place",
    "type": "<string>",
    "address": "<string>",
    "address_comment": "<string>",
    "latitude": 123,
    "longitude": 123,
    "region_id": 123,
    "city": "<string>",
    "district": "<string>",
    "rating": 123,
    "review_count": 123,
    "rating_count": 123,
    "org_rating": 123,
    "org_review_count": 123,
    "provider_ratings": [],
    "phone": "<string>",
    "website": "<string>",
    "email": "<string>",
    "socials": {},
    "ad_text": "<string>",
    "schedule": [],
    "rubrics": [],
    "primary_rubric": "<string>",
    "attributes": [],
    "org": {
      "id": "<string>",
      "@type": "@twogis_org",
      "name": "<string>",
      "branch_count": 123
    },
    "nearest_metro": [],
    "nearest_stations": [],
    "nearest_parking": [],
    "has_photos": false,
    "created_at": "<string>",
    "updated_at": "<string>",
    "url": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
query
string
required

Search query (keyword, brand, category)

Minimum string length: 1
Example:

"кафе"

count
integer
required

Max number of results

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
region_id
string | null

2GIS region id to search within (e.g. 32 = Moscow)

Example:

"32"

point
string | null

Center point 'lon,lat' to search around; use with radius

Example:

"37.62,55.75"

radius
integer | null

Search radius in meters around point

Required range: 1 <= x <= 40000
rubric_id
string | null

Filter by 2GIS rubric (category) id

Example:

"161"

sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
rating,
distance
sort_point
string | null

Reference point 'lon,lat' for distance sort

Example:

"37.62,55.75"

has_photos
boolean | null

Only places that have photos

open_now
boolean | null

Only places open at the current time

Response

Successful Response

id
string
required
name
string
required
@type
string
default:@twogis_place
type
string | null
address
string | null
address_comment
string | null
latitude
number | null
longitude
number | null
region_id
integer | null
city
string | null
district
string | null
rating
number | null
review_count
integer | null
rating_count
integer | null
org_rating
number | null
org_review_count
integer | null
provider_ratings
TwogisProviderRating · object[]
phone
string | null
website
string | null
email
string | null
socials
Socials · object
ad_text
string | null
schedule
TwogisScheduleDay · object[]
rubrics
TwogisRubric · object[]
primary_rubric
string | null
attributes
TwogisAttribute · object[]
org
TwogisOrg · object
nearest_metro
TwogisNearbyStation · object[]
nearest_stations
TwogisNearbyStation · object[]
nearest_parking
TwogisNearbyStation · object[]
has_photos
boolean
default:false
created_at
string | null
updated_at
string | null
url
string | null