Guía pública

Cómo consultar PLAN PAPAS

Esta guía explica cómo personas, buscadores y asistentes pueden leer el catálogo publicado sin iniciar sesión.

Fuentes oficiales para consultar

  • Explorador público: búsqueda y filtros para personas.
  • https://planpapas.com.ar/api/public/discovery: catálogo JSON de sólo lectura.
  • https://planpapas.com.ar/places/<id>: ficha canónica de cada lugar, con la información pública disponible y sus fuentes visibles cuando existen.

El catálogo sólo incluye fichas publicadas. No es un padrón exhaustivo ni promete cobertura completa de una zona. Las opciones y la cobertura cambian a medida que se publican, corrigen o archivan fichas.

Consultas de ejemplo

Usá siempre page, entre 1 y 1000. Cada página devuelve hasta 24 resultados.

https://planpapas.com.ar/api/public/discovery?page=1
https://planpapas.com.ar/api/public/discovery?q=museo&page=1
https://planpapas.com.ar/api/public/discovery?when=today&page=1
https://planpapas.com.ar/api/public/discovery?price=free&page=1
https://planpapas.com.ar/api/public/discovery?price=paid&page=1

today, weekend y las fechas se interpretan en la zona horaria America/Argentina/Buenos_Aires. Para un rango usá date_from=AAAA-MM-DD y date_to=AAAA-MM-DD.

Filtros públicos

q
Texto, hasta 120 caracteres.
zone, category, environment, keyword
Uno o más valores separados por coma. Reutilizá los nombres y slugs que muestra el explorador; no los adivines.
age_min, age_max
Edades enteras entre 0 y 21. El valor 21 significa 21 años o más.
when
today o weekend. Un rango de fechas tiene prioridad.
price
free o paid. Gratis sólo coincide con gratuidad confirmada; un precio desconocido no cuenta como gratis.
vegan, gluten_free, pet_friendly, restrooms, step_free, accessible_restroom
Usá 1 para exigir una característica pública confirmada.
lat, lng
Coordenadas válidas para ordenar por cercanía. Enviá ambas o ninguna.

Contrato de respuesta

{
  "version": 1,
  "canonical_url": "https://planpapas.com.ar/api/public/discovery?page=1",
  "page": 1,
  "page_size": 24,
  "total": 0,
  "has_more": false,
  "results": []
}

Los lugares incluyen sólo campos públicos de identidad, ubicación, edades, estado, confianza, promoción, disponibilidad, precio, servicios e imagen. La respuesta no incluye borradores, fichas archivadas, datos familiares, responsables, facturación, claves, auditorías privadas ni material interno de Research o Scout.

Cómo interpretar los datos

  • last_verified_at es la fecha real de verificación cuando existe. updated_at sólo indica una modificación técnica o editorial; no equivale a verificación.
  • price_level vale free, paid o null. null significa precio sin confirmar. price_range se conserva temporalmente para clientes anteriores.
  • Un valor nulo o ausente significa que PLAN PAPAS no lo confirma. Un booleano false en el catálogo no debe presentarse como ausencia verificada; sólo true confirma esa característica.
  • availability_label resume el contexto pedido. Si dice que el horario está sin confirmar, mantené esa advertencia.
  • featured y promoted son señales comerciales explícitas. No significan “recomendado” ni “verificado”.
  • trust_level describe el origen o gestión de la información. No reemplaza una comprobación actual con el lugar.

Citar y enlazar

Al usar un resultado, enlazá la canonical_url de la ficha y nombrá a PLAN PAPAS como fuente de consulta. Si mencionás un horario, precio o fecha, incluí la fecha de consulta y conservá cualquier aviso “a confirmar”. No presentes la respuesta como una recomendación personalizada ni como garantía de seguridad, calidad o disponibilidad.

Buscadores y asistentes

La política efectiva de rastreo está en robots.txt. La excepción pública del catálogo no abre otras rutas /api ni cambia permisos, tratamiento de datos o políticas de entrenamiento.

Referencias técnicas oficiales: Schema.org Place, OpeningHoursSpecification, crawlers de Google y crawlers de OpenAI.

Publicar esta guía, JSON-LD o un archivo de orientación no garantiza indexación, aparición en respuestas ni posición en resultados.