Skip to main content
POST
El Salvador Tourism Places Search

Authorizations

Authorization
string
header
required

Use Authorization: Bearer YOUR_API_KEY

Headers

Idempotency-Key
string

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Maximum string length: 255
Example:

"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"

Body

application/json
query
string
default:""

Optional search terms matched against the name, the description, the address, the town and the region.

Maximum string length: 200
kind
enum<string>
default:""

Optional kind of place: destination, attraction (a tourist site, public or private), restaurant, lodging, transport, recreation, tourist_info, surf_school or guide (a certified tour guide).

Available options:
,
destination,
attraction,
restaurant,
lodging,
transport,
recreation,
tourist_info,
surf_school,
guide
theme
enum<string>
default:""

Optional theme the Ministerio de Turismo files a destination under: surf_city, bitcoin (its Bitcoin destinations), nature_adventure, archaeology, towns, wellness or regional (destinations in neighbouring countries).

Available options:
,
surf_city,
bitcoin,
nature_adventure,
archaeology,
towns,
wellness,
regional
department
enum<string>
default:""

Optional department of El Salvador, e.g. La Libertad, Santa Ana, Usulután.

Available options:
,
Ahuachapán,
Cabañas,
Chalatenango,
Cuscatlán,
La Libertad,
La Paz,
La Unión,
Morazán,
San Miguel,
San Salvador,
San Vicente,
Santa Ana,
Sonsonate,
Usulután
municipality
string
default:""

Optional town or municipality, e.g. Suchitoto, Tamanique, Concepción de Ataco, matched from the start. Case and accents are ignored.

Maximum string length: 80
language
enum<string>
default:""

Optional language a tour guide works in, as an ISO 639 code: es, en, fr, it, de, pt or nah (Náhuat).

Available options:
,
es,
en,
fr,
it,
de,
pt,
nah
registered_only
boolean
default:false

When true, only businesses inscribed in the national tourism registry (Registro Nacional de Turismo).

page
integer
default:1

1-based page number for paginated results.

Required range: 1 <= x <= 1000
per_page
integer
default:20

Results per page (1-50).

Required range: 1 <= x <= 50

Response

Successful response

data
object
required