New Integration: Trivago

Description

Add Trivago integration to sync hotel search data, rate comparisons, booking conversions, and property listings into CORE.

Reference Implementations

Existing Integrations (use as templates)

• integrations/cal_com/ - Similar booking/scheduling system
• integrations/linear/ - Project management integration
• integrations/slack/ - For reference

Required Files Structure

integrations/trivago/
├── src/
│   ├── index.ts          # Main entry, API spec
│   ├── schedule.ts       # Sync logic
│   ├── utils.ts          # Trivago API utilities
│   ├── account-create.ts # Auth setup
│   └── create-activity.ts # Activity formatting
├── package.json
├── tsup.config.ts
└── README.md

Trivago API Integration

Authentication Setup

• Use Trivago Connectivity Suite credentials
• Partner authentication via the Developer Portal
• API key or OAuth-based authentication depending on the API surface

Key APIs

• FastConnect API - Direct interface for real-time hotel rates and availability
  • Pull live pricing from booking engines/reservation systems
  • Rate and availability responses per hotel per search
• Conversion API - Track booking conversions from Trivago clicks
  • POST /conversions - Submit conversion data
  • Track conversion rates and revenue attribution
• Express Booking Self-Connect API - In-app booking flow
  • OpenAPI/Swagger specification available
  • Full booking lifecycle management
  • Room availability, pricing, and reservation endpoints

Key Endpoints (Express Booking)

• POST /booking - Create a new booking
• GET /booking/{id} - Retrieve booking details
• PUT /booking/{id} - Modify a booking
• DELETE /booking/{id} - Cancel a booking
• GET /availability - Check room availability
• GET /rates - Get current rates for properties

Events to Track

1. Hotel Searches - Search queries, result impressions, rate comparisons
2. Booking Conversions - Click-throughs, completed bookings, revenue tracking
3. Rate Updates - Price changes, availability changes for tracked properties
4. Property Management - Property listing updates, new properties added

Implementation Tasks

• Set up basic integration structure following integrations/github/src/index.ts pattern
• Implement partner authentication flow in account-create.ts
• Create API utilities in utils.ts for FastConnect and Express Booking APIs
• Implement sync logic in schedule.ts for bookings and conversion data
• Convert hotel/booking events to CORE activity format
• Add error handling and rate limiting
• Create integration documentation
• Add to integrations/README.md

Technical Notes

• FastConnect establishes a direct connection between booking engines and Trivago for real-time pricing
• Express Booking Self-Connect API has an OpenAPI spec available on GitHub: trivago/express-booking-selfconnect-api
• Conversion tracking is essential for measuring ROI from Trivago advertising
• The swagger-codegen library can generate client code from the OpenAPI spec
• Documentation is hosted at developer.trivago.com

Resources

• Trivago Developer Portal
• FastConnect Documentation
• Conversion API Documentation
• Express Booking Self-Connect API (GitHub)
• Trivago GitHub Organization

Labels

enhancement, integration, new-feature