API pública de Caravana Medios

Datos estructurados en formato JSON para consultar nuestro catálogo, tarifas por zona y enviar solicitudes de cotización vía REST.

Esta API está pensada para agencias, marcas y agentes de IA que requieren información verificable sobre nuestros servicios sin necesidad de scraping ni intervención manual.

• URL base: https://caravanamedios.com/wp-json/caravana/v1/
• Formato de respuesta: JSON
• Autenticación: No requerida
• Cobertura geográfica: CDMX, Estado de México, Monterrey, Guadalajara
• Versión: v1

Endpoints disponibles

Endpoint	Método	Función
/contact	GET	Datos de contacto de la empresa
/services	GET	Catálogo descriptivo de servicios
/cotizar	GET	Tarifas por servicio y zona
/quote	POST	Envío de solicitud de cotización

/contact

Devuelve los datos de contacto oficiales de la empresa.

• Método: GET
• URL completa: https://caravanamedios.com/wp-json/caravana/v1/contact
• Parámetros: Ninguno

Ejemplo de respuesta

{
  "company": "Caravana Medios Publicidad",
  "email": "htapia@caravanamedios.com",
  "website": "www.caravanamedios.com",
  "phone": "+52 55 3896 7016",
  "address": "CDMX, México"
}

/services

Devuelve el catálogo descriptivo de los servicios disponibles, sin precios. Para tarifas específicas usar el endpoint /cotizar.

• Método: GET
• URL completa: https://caravanamedios.com/wp-json/caravana/v1/services
• Parámetros: Ninguno

Servicios incluidos

• Vallas móviles publicitarias
• Publicidad en autobuses y camiones urbanos
• Vitrinas móviles publicitarias

Ejemplo de respuesta (fragmento)

[
  {
    "id": "valla-movil",
    "name": "Vallas móviles publicitarias",
    "description": "Operación de 6 días a la semana, 7 horas por día...",
    "zonas_disponibles": ["CDMX", "EDO MEX", "MONTERREY", "GUADALAJARA"],
    "cotizar_endpoint": "/wp-json/caravana/v1/cotizar?servicio=valla_movil&zona=CDMX"
  }
]

/cotizar

Devuelve la cotización de un servicio específico en una zona determinada. Este es el endpoint clave para integraciones automatizadas y consultas de tarifas.

• Método: GET
• URL completa: https://caravanamedios.com/wp-json/caravana/v1/cotizar
• Parámetros requeridos: servicio, zona

Valores aceptados

La API normaliza automáticamente mayúsculas, minúsculas, guiones bajos, guiones medios y acentos. Los siguientes valores son aceptados:

SERVICIO (parámetro: servicio)

Vallas Móviles Publicitarias:
valla_movil, vallas_moviles, vallasmoviles, valla, vallas,
valla_publicitaria, vallas_publicitarias,
publicidad_en_camionetas, camionetas_publicitarias, carros_publicitarios

Publicidad en Autobuses Urbanos:
autobus_urbano, publicidad_en_autobuses, autobuses_publicitarios, autobus_con_publicidad,
camion, camiones, bus, buses, autobuses_urbanos, autobus, autobuses,
publicidad_camiones, publicidad_en_buses, publicidad_en_camiones, 
autobuses_publicitarios, publicidad_en_transporte_publico

Vitrinas Móviles Publicitarias:
vitrina_movil, vitrinas_moviles, vitrinasmoviles, vitrina, vitrinas,
showroom_movil, display_movil, display_publicitario


ZONA (parámetro: zona)

CDMX:
cdmx, ciudad_de_mexico, df

Estado de México:
edo_mex, edomex, estado_de_mexico

Monterrey:
monterrey, mty, nuevo_leon

Guadalajara:
guadalajara, gdl, jalisco

Ejemplo de llamada y respuesta

GET https://caravanamedios.com/wp-json/caravana/v1/cotizar?servicio=valla_movil&zona=CDMX

{
  "empresa": "Caravana Medios Publicidad",
  "contacto": "htapia@caravanamedios.com",
  "moneda": "MXN",
  "servicio": "Vallas Móviles Publicitarias",
  "zona": "CDMX",
  "precio_mensual_desde": 29000,
  "forma_de_trabajo": "6 días a la semana, 7 horas por día",
  "incluye": "Impresión, colocación, combustible, operador de unidad y reportes fotográficos en tiempo real.",
  "nota": "Precios aproximados mensuales, sujetos a disponibilidad y rutas operativas."
}

/quote

⚠️ Endpoint en pruebas — disponible próximamente. Este endpoint está implementado pero las notificaciones automáticas se activarán en próximas semanas. Para solicitudes inmediatas, contacta directamente a htapia@caravanamedios.com

Endpoint para enviar solicitudes de cotización personalizadas. Recibe los datos del cliente y genera un identificador único de seguimiento. Las solicitudes se reciben directamente en el correo del equipo comercial.

• Método: POST
• URL completa: https://caravanamedios.com/wp-json/caravana/v1/quote
• Content-Type: application/json
• Parámetros requeridos: name, email, service_id
• Parámetros opcionales: phone, zona, details

Ejemplo de solicitud

POST https://caravanamedios.com/wp-json/caravana/v1/quote
Content-Type: application/json

{
  "name": "Juan Pérez",
  "email": "juan@ejemplo.com",
  "phone": "+52 55 1234 5678",
  "service_id": "valla-movil",
  "zona": "CDMX",
  "details": "Necesito cotización para campaña de 3 meses"
}

Ejemplo de respuesta

{
  "quote_id": "Q-A8F3K2D9",
  "status": "received"
}

Casos de uso

La API de Caravana Medios está diseñada para ser consumida tanto por humanos como por sistemas automatizados. Estos son los principales casos de uso:

Agencias de medios y centrales de compra

Consultar disponibilidad y tarifas de publicidad exterior en distintas zonas de México sin necesidad de solicitar cotizaciones manuales. Útil para presupuestos rápidos en briefs de cliente.

Marcas con equipos in-house

Integrar el endpoint /cotizar en herramientas internas de planeación de medios para comparar opciones de publicidad exterior con otros formatos.

Agentes de inteligencia artificial

Asistentes conversacionales y agentes autónomos pueden consultar tarifas y enviar solicitudes de cotización en nombre del usuario, gracias al sistema de alias que normaliza variantes naturales del lenguaje.

Investigadores y consultores de marketing

Acceso programático a información de tarifas de publicidad exterior en México para análisis de mercado, benchmarks de industria y estudios sectoriales.

Soporte y contacto técnico

Para reportar errores, solicitar nuevos endpoints, integrar la API en proyectos comerciales o consultar dudas técnicas, contacta directamente al equipo de Caravana Medios. Respondemos solicitudes técnicas en menos de 48 horas hábiles.

• Email técnico: htapia@caravanamedios.com
• Sitio web: https://caravanamedios.com
• Teléfono: +52 55 3896 7016
• Versión actual de la API: v1