holaOlas logo
holaOlas logo
Back to TPDI

TPDI API

Programmatic access to structural tourism market data.

What it is

The TPDI API gives direct access to the dataset behind the Tourism Platform Dependence Index — city by city, market by market, activity by activity.

Every data point is based on real observed search results, manually classified. Not estimates. Not surveys. Structural data.

What you get

TPDI scores, ARI scores (with 5-block breakdown when available), and direct booking visibility percentages for every analyzed market. Actor distribution — how many local operators, platforms, and remote resellers occupy each market. Booking signal breakdown — direct, platform-only, contact-only, undetected. ARI history and delta per market. Continuously updated as new markets are added.

Currently 115 markets analyzed across 7 countries and 14 cities.

Endpoints

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

Authentication: x-api-key header

Format: JSON

Rate limit: 3,000 requests / day

GET /api/v1/markets

Global overview — total markets, cities, countries, average TPDI and ARI scores.

GET /api/v1/analyses

Full dataset with optional filters — country, city, activity, criteria.

GET /api/v1/analyses/:id

Complete structural detail for one market analysis.

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

ARI history with delta and trend per snapshot.

GET /api/v1/markets/history-summary

Bulk ARI delta per market (2 latest snapshots).

Example response

ari_score is the total ARI score (v2 when available, otherwise 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" }
}

Who it's for

Travel tech companies integrating market structure data into their own products. Consultants automating market reports for clients. DMOs tracking platform dependence across destinations over time. Academic researchers working with standardized, citable tourism data.

Methodology

Every analysis follows a standardized framework — same classification rules, same grid, every market. Manual verification per URL. Dated snapshots with documented variance margins. Full methodology is public at tpdi.io/methodology.

tpdi.io/methodology

Access

API access is available as part of an enterprise package. Includes onboarding call, priority support, and all dataset updates during the contract period.

To request access, fill out the contact form below — tell us your use case, your destination focus, and how you plan to use the data.

We'll generally confirm fit, send documentation, and set up your API key within 48 business hours.

Request API access

Enterprise pricing. No self-serve signup — each integration is onboarded individually.

TPDI API v1 · tpdi.io · Back to TPDI