> ## 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

> Busque no diretório oficial de turismo de El Salvador, de destinos e pontos turísticos a restaurantes, hospedagem, transporte, escolas de surfe e guias de turismo certificados, leia qualquer lugar completo com suas fotos e busque na agenda oficial de eventos.

O Ministerio de Turismo de El Salvador publica o diretório oficial de turismo do país: cerca de 3.800 lugares, entre eles 124 destinos classificados em temas como Surf City, Destinos Bitcoin, natureza e aventura, parques arqueológicos, cidades e povoados e saúde e bem-estar, 52 pontos turísticos públicos e privados, uns 2.200 restaurantes, 500 hospedagens, 370 serviços de transporte, recreação e informação turística, escolas de surfe e 300 guias de turismo certificados com os idiomas em que trabalham. Os negócios inscritos no Registro Nacional de Turismo vêm marcados como tais, e cada lugar chega com seu departamento e município e, para os negócios, os contatos que o diretório publica. O Ministério também mantém uma agenda de festivais, feiras, shows e eventos culturais em todo o país.

Busque no diretório por tipo, tema, departamento, município, idioma do guia ou texto livre, e depois leia qualquer lugar completo, com a descrição e as fotos de cada destino. Busque na agenda por intervalo de datas, departamento ou texto livre.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar lugares

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

Uma única busca sobre todo o diretório, filtrada por tipo, tema, departamento, município, idioma do guia ou inscrição no registro.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no nome, na descrição, no endereço, no município e na região, p. ex. `El Tunco`, `café`, `volcán`. |
| `kind` | enum | Tipo opcional: `destination`, `attraction`, `restaurant`, `lodging`, `transport`, `recreation`, `tourist_info`, `surf_school` ou `guide`. |
| `theme` | enum | Tema opcional de um destino: `surf_city`, `bitcoin`, `nature_adventure`, `archaeology`, `towns`, `wellness` ou `regional`. |
| `department` | enum | Departamento de El Salvador opcional, p. ex. `La Libertad`, `Santa Ana`, `Usulután`. |
| `municipality` | string | Município opcional, p. ex. `Suchitoto`, `Tamanique`, comparado desde o início. Maiúsculas e acentos são ignorados. |
| `language` | enum | Idioma opcional em que um guia trabalha: `es`, `en`, `fr`, `it`, `de`, `pt` ou `nah` (náhuat). |
| `registered_only` | boolean | Se true, só negócios inscritos no Registro Nacional de Turismo. Por padrão `false`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `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" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`: primeiro o que melhor corresponde quando há `query`, depois os inscritos no Registro Nacional de Turismo, depois os atualizados mais recentemente. Cada resultado traz `id` (o id permanente do lugar no diretório, p. ex. `2905`), `slug`, `name`, `kind`, `themes`, `guide_level` (para guias: `site`, `local` ou `national`), `registered` (inscrito no Registro Nacional de Turismo), `access` (para pontos turísticos: `public` ou `private`), `department`, `municipality`, `region`, `languages` (para guias), `hours`, `phones`, `emails`, `address`, `website`, `whatsapp`, `social_links`, `official_url` (a página do lugar no site oficial de turismo) e `updated_at`. Os guias trazem nome, idiomas, nível e área, nunca seus contatos pessoais: `phones`, `emails` e `address` vêm vazios para eles.

<Note>
  Os resultados da busca não incluem a descrição nem as fotos de um destino. Leia-as com o endpoint El Salvador Tourism Place.
</Note>

## Um lugar, completo

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

| Campo | Tipo | Notas |
| - | - | - |
| `place_id` | string | **Obrigatório.** O `id` do lugar retornado pela busca, p. ex. `2905`, seu `slug` ou sua `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" }'
```

Retorna `as_of`, `found`, `place_id` e `place`, que traz tudo o que a busca retorna mais `description` (o texto do Ministério sobre um destino) e `photos[]`: cada uma com `document_url` (a cópia da Croma da foto, idêntica byte a byte à publicada, que continua disponível aconteça o que acontecer com o link original) e `source_document_url` (a foto no site oficial). Cada resultado traz `id` (o id permanente do lugar no diretório, p. ex. `2905`), `slug`, `name`, `kind`, `themes`, `guide_level` (para guias: `site`, `local` ou `national`), `registered` (inscrito no Registro Nacional de Turismo), `access` (para pontos turísticos: `public` ou `private`), `department`, `municipality`, `region`, `languages` (para guias), `hours`, `phones`, `emails`, `address`, `website`, `whatsapp`, `social_links`, `official_url` (a página do lugar no site oficial de turismo) e `updated_at`. Os guias trazem nome, idiomas, nível e área, nunca seus contatos pessoais: `phones`, `emails` e `address` vêm vazios para eles.

<Note>
  Um id, slug ou link que o diretório não tem retorna `found: false` com HTTP 200, não um erro.
</Note>

## Buscar eventos

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

A agenda oficial, do mais próximo ao mais distante, por intervalo de datas, departamento ou texto livre.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no nome e no local do evento, p. ex. `festival`, `Suchitoto`. |
| `department` | enum | Departamento de El Salvador opcional, p. ex. `La Libertad`, `Santa Ana`, `Usulután`. |
| `from_date` | string | Opcional: só eventos ainda em andamento nesta data ou depois, `yyyy-mm-dd`. Hoje em El Salvador se omitido. |
| `to_date` | string | Opcional: só eventos que começam nesta data ou antes, `yyyy-mm-dd`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `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" }'
```

Retorna `as_of`, os filtros aplicados (com o `from_date` usado), `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, do mais próximo ao mais distante. Cada evento traz `id`, `slug`, `name`, `start_date`, `end_date`, `venue`, `department`, `links` (a página do organizador, ingressos ou uma publicação, quando a agenda os informa), `official_url` e `updated_at`.

<Note>
  Sem `from_date`, a busca retorna os eventos que ainda não terminaram, contando a partir de hoje em El Salvador.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>


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