API de actividades

Tours, atracciones y experiencias

Explora un catálogo, comprueba la disponibilidad por fecha y franja horaria, reserva y entrega un voucher. Un flujo REST, precios en USD.

GET /Activity/v2/products
GET /Activity/v2/products
  ?city=Tbilisi
  &sort=bestselling
  &per_page=20
Resumen

El contenido de actividades es amplio y la disponibilidad es sensible al tiempo. Esta API de actividades ofrece un catálogo con búsqueda, disponibilidad por fecha y franja con las horas pasadas ya filtradas, un flujo de reserva sencillo y vouchers descargables.

La API de tours y actividades envuelve un catálogo profundo de experiencias con disponibilidad real y sensible al tiempo. Categorías, idiomas, duraciones, niveles de precio e inventario por franja horaria se unifican en un solo flujo, para que vendas una visita a pie o una excursión con el mismo código que ya usas para vuelos y hoteles.

Lo que obtienes

1

Busca en el catálogo por ciudad, categoría, precio e idioma.

2

Lee fechas y franjas reservables, ya filtradas según la hora local de la actividad.

3

Crea una reserva, confírmala y descarga el voucher.

4

La disponibilidad se filtra contra la hora local de cada actividad, así nunca se muestran franjas pasadas.

5

Vouchers descargables y un evento de estado de reserva al que suscribirte en lugar de sondear.

Cómo funciona el flujo

01

Browse

Search the catalogue by city, category, price, or language.

02

Availability

Read bookable dates, then timeslots for a chosen date.

03

Book

Create a booking for a product-type and traveller mix.

04

Voucher

Confirm and download the voucher, or watch the status event.

Endpoints clave

GET/Activity/v2/productsSearch the activity catalogue.
GET/Activity/v2/availability/datesList bookable dates for a product.
GET/Activity/v2/availability/timeslotsList timeslots for a chosen date.
POST/Activity/v2/bookingsCreate a booking.
GET/Activity/v2/bookings/{id}/voucherDownload the voucher.

Solicitud y respuesta

Request · GET /Activity/v2/products
GET /Activity/v2/products
  ?city=Tbilisi
  &sort=bestselling
  &per_page=20
Response · 200 OK
{
  "products": [
    {
      "productId": "ACT-4410",
      "title": "Old Town Walking Tour",
      "durationMinutes": 120,
      "from": { "amount": 29.00, "currency": "USD" },
      "productTypes": [
        { "code": "ADULT", "label": "Adult ticket" }
      ]
    }
  ]
}

Qué incluye la respuesta

productId
Stable id for the activity.
productTypes
Bookable variants, such as ticket tiers or packages.
from
Lead-in price, in USD.
durationMinutes
Length of the experience.
cancellationPolicy
Free-cancellation window, if any.
2500+

Actividades en destinos de todo el mundo

Preguntas frecuentes

¿Cómo se devuelve la disponibilidad?

Como fechas reservables y como franjas para una fecha elegida. Lo que ya pasó se elimina según la hora local de la actividad.

¿Qué es un product-type?

Una variante reservable de un producto, como un nivel de entrada o un paquete. Reservas por su id.

¿Cuándo obtengo el voucher?

Cuando la reserva se emite. Puedes observar el evento de estado en lugar de hacer polling.

¿Cómo funcionan los product-types?

Un product-type es una variante reservable, como una entrada de adulto o un paquete. Reservas por su código junto con la composición de viajeros.

¿Puedo obtener el estado de reserva en vivo?

Sí. Suscríbete al evento de estado de reserva y recibe el voucher en cuanto se emite, sin sondeos.

Construye tu producto de viajes sobre una sola API.

Integración gratuita. 1 % por billete emitido, con tope de 10 $. Cobertura en vivo de vuelos, hoteles y actividades.