TIH API v2 Updates - A new version for all TIH APIs is now available and its older API versions will be deprecated in 2023. Click on the "News" tab for more information.
Search Map By Multiple Datasets

get

Search Map By Multiple Datasets

Provide the ability to search for a dataset, such as Attractions or Accommodation, within an area (identified by location and radius). A list of that dataset, along with the details, are then provided as a response to users.

Resource URL

https://api.stb.gov.sg/services/navigation/v2 /search

Header Parameters

Name Values Description
Content-Type

Format of the request body sent. Accepts only application/json.

X-Content-Language

Supported language [en | zh-cn | zh-tw | ja | ko].
Validation: acceptable language code

Query Parameters

Name Values Description
location
(required)

Filter records by location.
Field format: [latitude,longitude].
E.g. 1.2835627,103.8584985

radius

Radius in metre to restrict the search on.
Default value: 1000

dataset

Dataset which the search will be executed on. Possible value(s): [accommodation, attractions, bars_clubs, cruises, events, food_beverages, precincts, shops, tours, venues, walking_trails].
Provide one value or a comma-delimited string of values.
Validation: acceptable category

keyword

Keyword to look for within name, description, body and tags when performing the search function. Accept keyword or product uuid. To search for an exact phase, enclose the phase in quotation marks. Maximum 255 characters.

sort

Field name to sort. If no value is specified, default is to sort by distance_rating in ascending order. distance_rating sorts the records by location and distance in descending order, followed by name in ascending order.

sortOrder

Sort order.

distinct

Filter content to remove duplicated Places of Interest.

startDate

Event start date.
Date format: YYYY-MM-DD.

endDate

Event end date.
Date format: YYYY-MM-DD.

group

Retrieve Points of Interest related to wellness (Wellness), SG Clean certification (SGClean) or Singapore Tourism Awards (STA) by using the group value(s) (Wellness, SGClean, STA).
Provide one value or a comma-delimited string of values.
E.g. Wellness,SGClean,STA

offset

The position to return from the results.
By specifying offset, you retrieve a subset of records starting with the offset value. Offset works with limit, which determines how many records to retrieve starting from the offset.
If offset value exceeds the total number of records, the response will be empty.
Default value: 0 (starts from first record).
Validation: integer

limit

Maximum number of data records to return in a response.
Default set to 20, with maximum of 50. If the limit value exceeds the maximum, the response will return 50 data records.
Validation: integer

Try it out

HTTP Basic

OAuth 2.0

API Key

RESET

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

HTTP Code Description
400 Bad Request — Request was not accepted and could be due to malformed parameter (e.g. spelling error) or missing a required parameter.
401 Unauthorised — API key is invalid or was not provided.
403 Forbidden — API key does not have the permission to perform the request.
404 Resource Not Found — Requested resource (i.e. the resource URL) does not exist.
405 Method Not Allowed — The HTTP request method is not supported by the resource.
406 Not Acceptable — Requester's acceptable content type for the response does not match the content type returned by the resource.
414 Request URL Too Long — Request URL exceeded the maximum acceptable URL length.
415 Unsupported Media Type — Request's format is not supported by the resource.
422 Unprocessable Entity — Request was not accepted, often due to semantic errors, such as data format.
500 Server Errors — Something is not working on TIH's end, happened very rarely.

Resource Summary

Security Category

Navigation

Working...