ETERA API Documentation

curl -G https://api.etera.dev/experience/booking/management/exp_abc123/analytics \
     -H "Authorization: Bearer <token>" \
     -d period=month \
     -d startDate=2024-01-01 \
     -d endDate=2024-01-31

{
  "success": true,
  "experienceId": "exp_abc123",
  "period": "month",
  "analytics": {
    "totalBookings": 245,
    "confirmedBookings": 220,
    "cancelledBookings": 25,
    "averagePartySize": 3.2,
    "popularTimeSlots": [
      {
        "time": "19:00",
        "bookings": 45
      },
      {
        "time": "20:00",
        "bookings": 38
      },
      {
        "time": "18:30",
        "bookings": 32
      }
    ],
    "providerBreakdown": {
      "opentable": {
        "bookings": 180,
        "percentage": 73.5
      },
      "ai_calling": {
        "bookings": 45,
        "percentage": 18.4
      },
      "tablecheck": {
        "bookings": 20,
        "percentage": 8.1
      }
    },
    "revenueImpact": {
      "totalCover": 784,
      "estimatedRevenue": 15680,
      "averageSpendPerBooking": 64
    }
  }
}

Retrieve comprehensive booking analytics for experience management.

Analytics Include:

📊 Booking Statistics - Total, confirmed, cancelled bookings
👥 Customer Insights - Party size patterns, repeat customers
⏰ Time Analysis - Popular time slots, peak hours
🔌 Provider Performance - Success rates by booking method
💰 Revenue Impact - Estimated revenue, average spend
📈 Trends - Period-over-period comparisons

Time Periods:

Day - Last 24 hours
Week - Last 7 days
Month - Last 30 days (default)
Year - Last 365 days
Custom - Specify startDate and endDate

Retrieve comprehensive booking analytics for experience management. **Analytics Include:** - 📊 **Booking Statistics** - Total, confirmed, cancelled bookings - 👥 **Customer Insights** - Party size patterns, repeat customers - ⏰ **Time Analysis** - Popular time slots, peak hours - 🔌 **Provider Performance** - Success rates by booking method - 💰 **Revenue Impact** - Estimated revenue, average spend - 📈 **Trends** - Period-over-period comparisons **Time Periods:** - **Day** - Last 24 hours - **Week** - Last 7 days - **Month** - Last 30 days (default) - **Year** - Last 365 days - **Custom** - Specify startDate and endDate

Authentication

AuthorizationBearer

JWT token from @etera-ai/auth package (auth.etera.dev) - Format: Bearer <token>

Path parameters

experienceIdstringRequired

Experience identifier

Query parameters

periodenumOptional

Analytics time period

Allowed values:

startDatestringOptionalformat: "^\d{4}-\d{2}-\d{2}$"

Custom period start date

endDatestringOptionalformat: "^\d{4}-\d{2}-\d{2}$"

Custom period end date

Response

Analytics data retrieved successfully

successboolean or null

experienceIdstring or null

periodstring or null

analyticsobject or null

Get Booking Analytics

Authentication

Path parameters

Query parameters

Response

Errors