{
  "ejemplos": [
    {
      "pregunta": "Domos con jacuzzi cerca de Bogotá",
      "url": "https://glampings.co/api/v1/glampings?q=domo+con+jacuzzi+cerca+de+bogota"
    },
    {
      "pregunta": "Glamping pet friendly en Antioquia",
      "url": "https://glampings.co/api/v1/glampings?q=glamping+pet+friendly+en+antioquia"
    },
    {
      "pregunta": "Glamping near Cartagena with a pool",
      "url": "https://glampings.co/api/v1/glampings?q=glamping+near+cartagena+with+pool"
    },
    {
      "pregunta": "Lo que muestra la página Glamping con jacuzzi cerca a Bogotá",
      "url": "https://glampings.co/api/v1/glampings?pagina=/glamping-con-jacuzzi/cerca-a-bogota"
    },
    {
      "pregunta": "Lo que muestra la página Glamping en Boyacá",
      "url": "https://glampings.co/api/v1/glampings?pagina=/colombia/glamping-boyaca"
    },
    {
      "pregunta": "Domos a menos de 60 km de Medellín",
      "url": "https://glampings.co/api/v1/glampings?cerca_a=medellin&max_km=60&tipo=domos"
    },
    {
      "pregunta": "Glampings en Guatavita con reserva por WhatsApp",
      "url": "https://glampings.co/api/v1/glampings?destino=Guatavita&solo_whatsapp=true"
    }
  ],
  "ficha_ejemplo": "https://glampings.co/api/v1/glampings/ecolodge-el-almejal",
  "nombre": "API pública de glampings.co",
  "descripcion": "Directorio de glamping y alojamientos únicos en Colombia: domos, cabañas, burbujas, ecolodges y más. Solo lectura, sin clave, con CORS abierto. Respuestas en JSON con claves en español. Pregunta en texto libre con q, o pide los alojamientos de una página de glampings.co con pagina.",
  "version": "1.1.0",
  "endpoints": [
    {
      "metodo": "GET",
      "ruta": "/api/v1/glampings",
      "descripcion": "Buscar alojamientos: q (texto libre), pagina (ruta de una página) o filtros, con paginación",
      "ejemplo": "https://glampings.co/api/v1/glampings?q=domo+con+jacuzzi+cerca+de+bogota"
    },
    {
      "metodo": "GET",
      "ruta": "/api/v1/glampings/{slug}",
      "descripcion": "Ficha completa de un alojamiento",
      "ejemplo": "https://glampings.co/api/v1/glampings/ecolodge-el-almejal"
    },
    {
      "metodo": "GET",
      "ruta": "/api/v1/destinos",
      "descripcion": "Departamentos, ciudades, regiones y municipios con número de glampings",
      "ejemplo": "https://glampings.co/api/v1/destinos"
    },
    {
      "metodo": "GET",
      "ruta": "/api/v1/categorias",
      "descripcion": "Tipos, temas y características (valores de filtro)",
      "ejemplo": "https://glampings.co/api/v1/categorias"
    },
    {
      "metodo": "GET",
      "ruta": "/api/v1/openapi.json",
      "descripcion": "Especificación OpenAPI 3.1",
      "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)."
  },
  "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/llms.txt",
    "llms_full_txt": "https://glampings.co/llms-full.txt",
    "agentes": "https://glampings.co/agentes",
    "sitio": "https://glampings.co"
  },
  "reglas": {
    "reserva": "Para reservar, envía al usuario a la ficha (url en los resultados, reserva.url_ficha en la ficha completa). Si la reserva es por whatsapp, allí pulsa el botón de WhatsApp: reserva directa con el alojamiento, sin comisiones. Esta API no contiene números de teléfono.",
    "precios": "No inventes precios ni disponibilidad. precio_desde solo existe cuando el alojamiento lo indicó, con su fecha de confirmación.",
    "ubicacion": "La ubicación es el centro del municipio, no la dirección del alojamiento. Las distancias son en línea recta.",
    "citacion": "Cita la fuente: cada respuesta trae fuente.url (la página de glampings.co) y fuente.cita_sugerida. En los resultados, cada ficha tiene su url.",
    "etiquetas": "Usa las etiquetas en español tal como vienen (tipos, temas y características).",
    "limite": "60 solicitudes por minuto por IP. Respuestas en caché 5 minutos."
  },
  "fuente": {
    "sitio": "glampings.co",
    "url": "https://glampings.co/",
    "cita_sugerida": "Fuente: glampings.co, Glamping y alojamientos únicos en Colombia (https://glampings.co/)"
  }
}