> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ministerio de Turismo

> Busca en el directorio oficial de turismo de El Salvador, de destinos y sitios turísticos a restaurantes, alojamiento, transporte, escuelas de surf y guías de turismo certificados, lee cualquier lugar completo con sus fotos y busca en la agenda oficial de eventos.

El Ministerio de Turismo de El Salvador publica el directorio oficial de turismo del país: unos 3.800 lugares, entre ellos 124 destinos clasificados en temáticas como Surf City, Destinos Bitcoin, naturaleza y aventura, parques arqueológicos, pueblos y ciudades y salud y bienestar, 52 sitios turísticos públicos y privados, unos 2.200 restaurantes, 500 alojamientos, 370 servicios de transporte, recreación e información turística, escuelas de surf y 300 guías de turismo certificados con los idiomas en que trabajan. Los negocios inscritos en el Registro Nacional de Turismo vienen marcados como tales, y cada lugar llega con su departamento y municipio y, para los negocios, los datos de contacto que publica el directorio. El Ministerio también lleva una agenda de festivales, ferias, conciertos y eventos culturales en todo el país.

Busca en el directorio por tipo, temática, departamento, municipio, idioma del guía o texto libre, y luego lee cualquier lugar completo, con la descripción y las fotos de cada destino. Busca en la agenda por rango de fechas, departamento o texto libre.

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar lugares

`POST /sv/mitur-sv/places-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

Una sola búsqueda sobre todo el directorio, filtrada por tipo, temática, departamento, municipio, idioma del guía o inscripción en el registro.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el nombre, la descripción, la dirección, el municipio y la región, p. ej. `El Tunco`, `café`, `volcán`. |
| `kind` | enum | Tipo opcional: `destination`, `attraction`, `restaurant`, `lodging`, `transport`, `recreation`, `tourist_info`, `surf_school` o `guide`. |
| `theme` | enum | Temática opcional de un destino: `surf_city`, `bitcoin`, `nature_adventure`, `archaeology`, `towns`, `wellness` o `regional`. |
| `department` | enum | Departamento de El Salvador opcional, p. ej. `La Libertad`, `Santa Ana`, `Usulután`. |
| `municipality` | string | Municipio opcional, p. ej. `Suchitoto`, `Tamanique`, comparado desde el inicio. No importan mayúsculas ni tildes. |
| `language` | enum | Idioma opcional en que trabaja un guía: `es`, `en`, `fr`, `it`, `de`, `pt` o `nah` (náhuat). |
| `registered_only` | boolean | Si es true, solo negocios inscritos en el Registro Nacional de Turismo. Por defecto `false`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/sv/mitur-sv/places-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "El Tunco", "kind": "lodging", "department": "La Libertad" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`: primero el que mejor coincide cuando hay `query`, luego los inscritos en el Registro Nacional de Turismo, luego los actualizados más recientemente. Cada resultado incluye `id` (el id permanente del lugar en el directorio, p. ej. `2905`), `slug`, `name`, `kind`, `themes`, `guide_level` (para guías: `site`, `local` o `national`), `registered` (inscrito en el Registro Nacional de Turismo), `access` (para sitios turísticos: `public` o `private`), `department`, `municipality`, `region`, `languages` (para guías), `hours`, `phones`, `emails`, `address`, `website`, `whatsapp`, `social_links`, `official_url` (la página del lugar en el sitio oficial de turismo) y `updated_at`. Los guías traen su nombre, idiomas, nivel y zona, nunca sus datos de contacto personales: `phones`, `emails` y `address` van vacíos para ellos.

<Note>
  Los resultados de búsqueda no incluyen la descripción ni las fotos de un destino. Léelas con el endpoint El Salvador Tourism Place.
</Note>

## Un lugar, completo

`POST /sv/mitur-sv/place/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

| Campo | Tipo | Notas |
| - | - | - |
| `place_id` | string | **Obligatorio.** El `id` del lugar que devuelve la búsqueda, p. ej. `2905`, su `slug` o su `official_url`. |

```bash theme={"dark"}
curl https://api.croma.run/sv/mitur-sv/place/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "place_id": "2905" }'
```

Devuelve `as_of`, `found`, `place_id` y `place`, que trae todo lo que devuelve la búsqueda más `description` (el texto del Ministerio sobre un destino) y `photos[]`: cada una con `document_url` (la copia de Croma de la foto, idéntica byte a byte a la publicada, que sigue disponible pase lo que pase con el enlace original) y `source_document_url` (la foto en el sitio oficial). Cada resultado incluye `id` (el id permanente del lugar en el directorio, p. ej. `2905`), `slug`, `name`, `kind`, `themes`, `guide_level` (para guías: `site`, `local` o `national`), `registered` (inscrito en el Registro Nacional de Turismo), `access` (para sitios turísticos: `public` o `private`), `department`, `municipality`, `region`, `languages` (para guías), `hours`, `phones`, `emails`, `address`, `website`, `whatsapp`, `social_links`, `official_url` (la página del lugar en el sitio oficial de turismo) y `updated_at`. Los guías traen su nombre, idiomas, nivel y zona, nunca sus datos de contacto personales: `phones`, `emails` y `address` van vacíos para ellos.

<Note>
  Un id, slug o enlace que el directorio no tiene devuelve `found: false` con HTTP 200, no un error.
</Note>

## Buscar eventos

`POST /sv/mitur-sv/events-search/v1` <a className="dataset-pill" href="/es/datasets">Dataset</a>

La agenda oficial, del más próximo al más lejano, por rango de fechas, departamento o texto libre.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el nombre y el lugar del evento, p. ej. `festival`, `Suchitoto`. |
| `department` | enum | Departamento de El Salvador opcional, p. ej. `La Libertad`, `Santa Ana`, `Usulután`. |
| `from_date` | string | Opcional: solo eventos que siguen en curso en esta fecha o después, `yyyy-mm-dd`. Hoy en El Salvador si se omite. |
| `to_date` | string | Opcional: solo eventos que empiezan en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/sv/mitur-sv/events-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "department": "San Salvador" }'
```

Devuelve `as_of`, los filtros aplicados (con el `from_date` que se usó), `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, del más próximo al más lejano. Cada evento incluye `id`, `slug`, `name`, `start_date`, `end_date`, `venue`, `department`, `links` (la página del organizador, la boletería o una publicación, cuando la agenda los da), `official_url` y `updated_at`.

<Note>
  Sin `from_date`, la búsqueda devuelve los eventos que aún no terminan, contando desde hoy en El Salvador.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.