Search the directory (metered)

Say where to look with city (a NUM destination — see /api/agent/destinations) or country; narrow with area, q and category. A city that is not a destination is read as a neighbourhood when country is given, and refused with instructions otherwise. Places NUM knows have closed are never returned.

get/api/agent/search

Request

  • Base URL: https://itsnum.com
  • URL: https://itsnum.com/api/agent/search
  • Auth: HTTP bearer

Query parameters

citystring

A NUM destination, e.g. Phuket. Required unless country is given.

countrystring

ISO-2 code or name, e.g. TH or Thailand.

areastring

A neighbourhood inside the destination, e.g. Kata.

qstring

Free text matched against the place name.

categorystring
limitinteger

Default 20, cap 50.

Response

Matching places.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.