{
  "ejemplos": [
    {
      "pregunta": "Domes with a hot tub near Bogotá",
      "url": "https://glampings.co/api/v1/glampings?q=dome+with+jacuzzi+near+bogota&lang=en"
    },
    {
      "pregunta": "Pet-friendly glamping in Antioquia",
      "url": "https://glampings.co/api/v1/glampings?q=glamping+pet+friendly+en+antioquia&lang=en"
    },
    {
      "pregunta": "Glamping near Cartagena with a pool",
      "url": "https://glampings.co/api/v1/glampings?q=glamping+near+cartagena+with+pool&lang=en"
    },
    {
      "pregunta": "The stays on the glampings.co page /glamping-con-jacuzzi/cerca-a-bogota",
      "url": "https://glampings.co/api/v1/glampings?pagina=/glamping-con-jacuzzi/cerca-a-bogota&lang=en"
    },
    {
      "pregunta": "The stays on the glampings.co page /colombia/glamping-boyaca",
      "url": "https://glampings.co/api/v1/glampings?pagina=/colombia/glamping-boyaca&lang=en"
    },
    {
      "pregunta": "Domes within 60 km of Medellín",
      "url": "https://glampings.co/api/v1/glampings?cerca_a=medellin&max_km=60&tipo=domos&lang=en"
    },
    {
      "pregunta": "Glamping in Guatavita with booking on WhatsApp",
      "url": "https://glampings.co/api/v1/glampings?destino=Guatavita&solo_whatsapp=true&lang=en"
    }
  ],
  "ficha_ejemplo": "https://glampings.co/api/v1/glampings/ecolodge-el-almejal?lang=en",
  "nombre": "glampings.co public API",
  "descripcion": "Directory of glamping and unique stays in Colombia: domes, cabins, bubbles, ecolodges and more. Read-only, no key, open CORS. JSON responses with Spanish keys; with lang=en the labels, texts and URLs are in English. Ask a free-text question with q, or get the stays of a glampings.co page with pagina.",
  "version": "1.2.0",
  "endpoints": [
    {
      "metodo": "GET",
      "ruta": "/api/v1/glampings",
      "descripcion": "Search stays: q (free text), pagina (path of a page) or filters, with pagination",
      "ejemplo": "https://glampings.co/api/v1/glampings?q=dome+with+jacuzzi+near+bogota&lang=en"
    },
    {
      "metodo": "GET",
      "ruta": "/api/v1/glampings/{slug}",
      "descripcion": "Full listing of one stay",
      "ejemplo": "https://glampings.co/api/v1/glampings/ecolodge-el-almejal?lang=en"
    },
    {
      "metodo": "GET",
      "ruta": "/api/v1/destinos",
      "descripcion": "Departments, cities, regions and towns with their number of glamping stays",
      "ejemplo": "https://glampings.co/api/v1/destinos?lang=en"
    },
    {
      "metodo": "GET",
      "ruta": "/api/v1/categorias",
      "descripcion": "Types, themes and features (filter values)",
      "ejemplo": "https://glampings.co/api/v1/categorias?lang=en"
    },
    {
      "metodo": "GET",
      "ruta": "/api/v1/openapi.json",
      "descripcion": "OpenAPI 3.1 specification",
      "ejemplo": "https://glampings.co/api/v1/openapi.json"
    }
  ],
  "filtros_busqueda": {
    "q": "Pregunta en texto libre, en español o inglés, p. ej. \"domo con jacuzzi cerca de bogota\" o \"glamping pet friendly en antioquia\". Se traduce sin IA a los filtros de abajo; la respuesta muestra lo aplicado en interpretacion y las palabras sin entender en no_entendido. Los demás parámetros tienen prioridad sobre q.",
    "pagina": "Ruta de una página de categoría de glampings.co, p. ej. \"/glamping-con-jacuzzi/cerca-a-bogota\", \"/colombia/glamping-boyaca\" o \"/colombia\": devuelve los mismos alojamientos y en el mismo orden que esa página (también fichas no indexables, con indexable = false). Solo se combina con limit y offset.",
    "destino": "Texto libre como en el buscador de glampings.co: municipio, zona, departamento, región o paisaje (p. ej. \"Guatavita\", \"Eje Cafetero\", \"Cañón del Chicamocha\") o ciudad (\"Bogotá\" = Bogotá y alrededores). Si no se reconoce, se busca el texto en nombre, municipio, zona y departamento.",
    "departamento": "Nombre o slug del departamento, p. ej. \"Cundinamarca\" o \"boyaca\".",
    "municipio": "Nombre del municipio, p. ej. \"Guatavita\". Combínalo con departamento si el nombre se repite.",
    "cerca_a": "Ciudad de referencia (slug o nombre): bogota, medellin, cali, bucaramanga, pereira, manizales, armenia, villavicencio, ibague, santa-marta, cartagena, tunja, popayan. Sin max_km: dentro del radio que usa glampings.co para esa ciudad. Ordena por distancia.",
    "max_km": "Distancia máxima en km, en línea recta desde el centro del municipio del alojamiento hasta la ciudad de cerca_a (1 a 500). Requiere cerca_a.",
    "tipo": "Uno o varios tipos de alojamiento, separados por coma; basta con que cumpla uno: domos, burbujas, tipis, casas-del-arbol, cabanas-alpinas, tiny-houses, yurtas, carpas-safari, contenedores, casas-hobbit, iglus, malocas, palafitos, casas-flotantes, capsulas, cuevas, chalets, cabanas, ecolodges, glamping.",
    "tema": "Uno o varios temas, separados por coma; deben cumplirse todos: con-jacuzzi, para-parejas, con-vista, con-chimenea, con-piscina, junto-al-rio, en-el-lago, en-la-playa, pet-friendly.",
    "caracteristica": "Una o varias características, separadas por coma; deben cumplirse todas: jacuzzi, piscina, mascotas, parejas, vista, lago, playa, rio, chimenea, familias, sauna-spa, malla-catamaran, desayuno.",
    "mascotas": "true = solo alojamientos que aceptan mascotas (tema pet-friendly).",
    "solo_whatsapp": "true = solo alojamientos que reciben la reserva directa por WhatsApp desde la ficha.",
    "con_precio": "true = solo alojamientos con precio desde indicado por el propio alojamiento.",
    "limit": "Resultados por página, 1 a 50 (por defecto 10).",
    "offset": "Resultados que se saltan, para paginar (desde 0).",
    "lang": "Idioma de la respuesta / response language: es (por defecto) o en. Con en, etiquetas, textos, fuente, avisos, mensajes de error y URLs (páginas y Markdown en /en) vienen en inglés; las claves y los valores de filtro (slugs) no cambian. With en, labels, texts, citations, notices, errors and URLs (English pages and Markdown under /en) are in English; keys and filter values (slugs) stay the same."
  },
  "paginacion": {"limit_por_defecto": 10, "limit_maximo": 50, "campo_siguiente": "siguiente_offset", "url_siguiente": "siguiente_url"},
  "enlaces": {
    "openapi": "https://glampings.co/api/v1/openapi.json",
    "mcp": "https://glampings.co/mcp",
    "llms_txt": "https://glampings.co/en/llms.txt",
    "llms_full_txt": "https://glampings.co/en/llms-full.txt",
    "agentes": "https://glampings.co/en/agents",
    "sitio": "https://glampings.co/en"
  },
  "reglas": {
    "reserva": "To book, send the user to the listing page (url in the results, reserva.url_ficha in the full listing). If booking is by whatsapp, they tap the WhatsApp button there: direct booking with the stay, with no commission. This API contains no phone numbers.",
    "precios": "Don't invent prices or availability. precio_desde only exists when the stay gave it, with its confirmation date.",
    "ubicacion": "The location is the center of the town, not the stay's address. Distances are in a straight line.",
    "citacion": "Cite the source: every response has fuente.url (the glampings.co page) and fuente.cita_sugerida. In the results, every listing has its url.",
    "etiquetas": "Use the labels as they come (English with lang=en). Filter values are the Spanish slugs (tipo=domos, tema=con-jacuzzi).",
    "limite": "60 requests per minute per IP. Responses cached for 5 minutes."
  },
  "fuente": {
    "sitio": "glampings.co",
    "url": "https://glampings.co/en",
    "cita_sugerida": "Source: glampings.co, Glamping and unique stays in Colombia (https://glampings.co/en)"
  }
}