TPDI API

Accès programmatique aux données structurelles des marchés touristiques.

Ce que c'est

L'API TPDI donne accès direct au jeu de données derrière l'indice de dépendance aux plateformes — ville par ville, marché par marché, activité par activité.

Chaque point de données repose sur des résultats de recherche réels et observés, classés manuellement. Pas d'estimations. Pas de sondages. Des données structurelles.

Ce que vous obtenez

Scores TPDI, scores ARI (avec breakdown 5 blocs quand disponible) et pourcentages de visibilité en réservation directe pour chaque marché analysé. Répartition des acteurs — combien d'opérateurs locaux, plateformes et revendeurs distants occupent chaque marché. Détail des signaux de réservation — direct, plateforme uniquement, contact uniquement, non détecté. Historique ARI et delta par marché. Mise à jour continue au fil des nouveaux marchés.

Actuellement 115 marchés analysés dans 7 pays et 14 villes.

Endpoints

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

Authentification : header x-api-key

Format : JSON

Limite : 3 000 requêtes / jour

GET /api/v1/markets

Vue globale — total marchés, villes, pays, scores TPDI et ARI moyens.

GET /api/v1/analyses

Dataset complet avec filtres optionnels — pays, ville, activité, critère.

GET /api/v1/analyses/:id

Détail structurel complet pour une analyse de marché.

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

Historique ARI avec delta et tendance par snapshot.

GET /api/v1/markets/history-summary

Résumé delta ARI par marché (2 derniers snapshots).

Exemple de réponse

ari_score correspond au score ARI total (v2 si disponible, sinon 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" }
}

Pour qui

Entreprises de voyage intégrant des données structurelles dans leurs produits. Consultants automatisant des rapports marché pour clients. DMO suivant la dépendance aux plateformes par destination. Chercheurs académiques travaillant avec des données touristiques standardisées et citables.

Méthodologie

Chaque analyse suit un cadre standardisé — mêmes règles de classification, même grille, partout. Vérification manuelle par URL. Snapshots datés avec marges de variance documentées. Méthodologie complète publique sur tpdi.io/methodology.

tpdi.io/methodology

Accès

L'accès API est disponible dans le cadre d'un forfait entreprise. Inclut onboarding, support prioritaire et toutes les mises à jour du dataset pendant la période.

Pour demander l'accès, remplissez le formulaire ci-dessous — indiquez votre cas d'usage, vos destinations cibles et comment vous comptez utiliser les données.

Nous confirmerons généralement la pertinence, enverrons la documentation et configurerons votre clé API sous 48h ouvrables.

Demander l'accès API

Tarification entreprise. Pas d'inscription en libre-service — chaque intégration est onboardée individuellement.

TPDI API v1 · tpdi.io · Retour au TPDI