holaOlas logo
holaOlas logo
Volver al TPDI

TPDI API

Acceso programático a datos estructurales de mercados turísticos.

Qué es

La API TPDI da acceso directo al conjunto de datos detrás del índice de dependencia de plataformas — ciudad por ciudad, mercado por mercado, actividad por actividad.

Cada punto de datos se basa en resultados de búsqueda reales observados, clasificados manualmente. No estimaciones. No encuestas. Datos estructurales.

Qué obtienes

Scores TPDI, scores ARI (con breakdown 5 bloques cuando disponible) y porcentajes de visibilidad de reserva directa para cada mercado analizado. Distribución de actores — cuántos operadores locales, plataformas y revendedores distantes ocupan cada mercado. Desglose de señales de reserva — directo, solo plataforma, solo contacto, no detectado. Historial ARI y delta por mercado. Actualización continua al añadir nuevas mercados.

Actualmente 115 mercados analizados en 7 países y 14 ciudades.

Endpoints

URL base: https://tpdi.io/api/v1

Autenticación: header x-api-key

Formato: JSON

Límite: 3.000 solicitudes / día

GET /api/v1/markets

Vista global — total mercados, ciudades, países, scores TPDI y ARI medios.

GET /api/v1/analyses

Dataset completo con filtros opcionales — país, ciudad, actividad, criterio.

GET /api/v1/analyses/:id

Detalle estructural completo para un análisis de mercado.

GET /api/v1/analyses/:id/history

Historial ARI con delta y tendencia por snapshot.

GET /api/v1/markets/history-summary

Resumen delta ARI por mercado (2 últimos snapshots).

Ejemplo de respuesta

ari_score corresponde al score ARI total (v2 si disponible, si no v1).

{
  "data": {
    "id": "90dfa53a-e63b-4dea-86a0-344e309ee9e2",
    "country": "Mexico",
    "city": "Cancun",
    "activity": "Accommodation",
    "criteria": "Luxury",
    "tpdi_score": 84,
    "ari_score": 37,
    "ari_breakdown": {
      "structure": 18,
      "execution": 12,
      "completeness": 14,
      "freshness": 5,
      "performance": 6
    },
    "direct_booking_pct": 14,
    "dominant_booking_signal": "platform_only",
    "sample_size": 28,
    "analyzed_at": "2026-02-15",
    "actor_distribution": {
      "local_strict": 3,
      "local_extended": 2,
      "platform": 18,
      "reseller_remote": 4,
      "dmo": 1
    },
    "booking_signals": {
      "direct": 4,
      "platform_only": 22,
      "contact_only": 1,
      "none": 1
    },
    "actors": [
      {
        "position": 1,
        "url": "https://www.viator.com/cancun",
        "actor_type": "platform",
        "booking_signal": "platform_only",
        "direct_booking_engine": null
      },
      {
        "position": 4,
        "url": "https://www.cancunadventures.com",
        "actor_type": "local_strict",
        "booking_signal": "direct",
        "direct_booking_engine": "fareharbor"
      }
    ]
  },
  "meta": { "id": "90dfa53a-e63b-4dea-86a0-344e309ee9e2" }
}

Para quién

Empresas de viajes integrando datos estructurales en sus productos. Consultores automatizando informes de mercado. DMO siguiendo la dependencia de plataformas por destino. Investigadores académicos con datos turísticos estandarizados y citables.

Metodología

Cada análisis sigue un marco estandarizado — mismas reglas de clasificación, misma cuadrícula, cada mercado. Verificación manual por URL. Snapshots fechados con márgenes de varianza documentados. Metodología completa pública en tpdi.io/methodology.

tpdi.io/methodology

Acceso

El acceso API está disponible como parte de un paquete empresarial. Incluye onboarding, soporte prioritario y todas las actualizaciones del dataset durante el contrato.

Para solicitar acceso, complete el formulario a continuación — indique su caso de uso, sus destinos de interés y cómo planea usar los datos.

Generalmente confirmaremos el encaje, enviaremos la documentación y configuraremos su clave API en 48h laborables.

Solicitar acceso API

Precios empresariales. Sin inscripción por cuenta propia — cada integración se incorpora individualmente.

TPDI API v1 · tpdi.io · Volver al TPDI