Entwickler-API
Portugal Directs Open-Data-API stellt den weltweit umfassendsten, KI-angereicherten Katalog portugiesischer Touren und Erlebnisse bereit – entwickelt für DMOs, OTAs, Buchungsplattformen und Reise-Apps.
Basis-URL
Übersicht
Die Portugal Direct API bietet programmatischen Zugang zu unserem normalisierten Tourenkatalog. Daten werden von Bokun, FareHarbor, Rezdy, GetYourGuide API und Turismo de Portugal Open Data eingespielt – alle 4 Stunden aktualisiert. Alle Tourbeschreibungen sind mit GPT-4o in DE, EN, PT, ES, FR und IT angereichert. Jedes Tour-Objekt enthält Schema.org TouristTrip JSON-LD-Metadaten für die Google Things-to-do-Integration.
Authentifizierung
Alle Anfragen erfordern einen API-Schlüssel, der als Bearer-Token im Authorization Header übergeben wird.
Authorization: Bearer pd_live_YOUR_API_KEYAPI-Schlüssel anfordern
Kostenloser Tarif: 1.000 Anfragen/Tag · Bezahlt: 50.000 Anfragen/Tag mit SLA
Ratenbegrenzung
| Tarif | Anfragen/Tag | Burst-Limit | Preis |
|---|---|---|---|
| Free | 1,000 | 10 req/min | €0 / month |
| Starter | 10,000 | 60 req/min | €29 / month |
| Business | 50,000 | 300 req/min | €99 / month |
| Enterprise | Unbegrenzt | Individuelle SLA | Individuell |
Ratenbegrenzungs-Header sind in jeder Antwort enthalten: X-RateLimit-Remaining, X-RateLimit-Reset.
Endpunkte
Tour-Objekt-Schema
interface Tour {
id: number; // Portugal Direct internal ID
slug: string; // URL-safe identifier
supplier_id: string; // Supplier slug
source: string; // "bokun"|"fareharbor"|"rezdy"|"gyg"|"tp-open"
title: Record<LangCode, string>; // Multilingual titles
description: Record<LangCode, string>; // AI-enriched descriptions
highlights: Record<LangCode, string[]>;
category: TourCategory;
destination: string;
location: { lat: number; lng: number; region: string; };
duration: number; // hours
price: { amount: number; currency: "EUR"; };
rating: number; // 0–5
reviews: number;
languages: LangCode[];
max_group: number;
photos: string[]; // CDN URLs
tags: string[];
ai_enriched: boolean;
schema_org: object; // Schema.org TouristTrip JSON-LD
supplier: SupplierRef;
updated_at: string; // ISO 8601
}
type LangCode = "de" | "en" | "pt" | "es" | "fr" | "it";
type TourCategory = "walking_tour" | "day_trip" | "boat_tour" | "gastronomy" | "adventure" | "multi_day";Änderungsprotokoll
Mai 2026 — Erstveröffentlichung
- 6 öffentliche Endpunkte live
- Bokun, FareHarbor, Rezdy, GYG, Turismo de Portugal Konnektoren
- GPT-4o-Anreicherung in 6 Sprachen
- Schema.org TouristTrip auf allen Tour-Objekten
- Kostenloser Tarif (1.000 Anfragen/Tag) ohne Kreditkarte verfügbar
Q3 2026 — Geplant
Verfügbarkeitskalender-Endpunkt · Webhook-Support · GraphQL-Schicht