Skip to main content
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.
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.

Buscar lugares

POST /sv/mitur-sv/places-search/v1 Dataset Uma única busca sobre todo o diretório, filtrada por tipo, tema, departamento, município, idioma do guia ou inscrição no registro.
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.
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.

Um lugar, completo

POST /sv/mitur-sv/place/v1 Dataset
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.
Um id, slug ou link que o diretório não tem retorna found: false com HTTP 200, não um erro.

Buscar eventos

POST /sv/mitur-sv/events-search/v1 Dataset A agenda oficial, do mais próximo ao mais distante, por intervalo de datas, departamento ou texto livre.
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.
Sem from_date, a busca retorna os eventos que ainda não terminaram, contando a partir de hoje em El Salvador.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.