AI Destination & Market Insights API

Technical Docs Demand Forecasting Market Opportunity Scoring Trend Detection
Operated by Spyface Tech Company, LLC • 30 N Gould St Ste N, Sheridan, WY 82801 USA • Support: hello@spyface.com

What this API actually does

The AI Destination & Market Insights API converts fragmented travel signals into quantified market decisions. Instead of static reports, it delivers forward-looking demand forecasts, opportunity scores, and early trend detection that can be embedded directly into pricing, supply planning, and go-to-market systems.

Most “insights tools” explain the past. Spyface is built to decide the future.

Primary outputs

Demand forecasts with confidence bands (P50 / P90)
Market opportunity score per destination
Trend velocity (early vs late signal)
Supply–demand imbalance
Actionable signals (expand, throttle, test)

1) Overview

Destination strategy usually fails because decisions are made on lagging indicators (last year bookings, quarterly reports). Spyface models destinations as dynamic systems with leading signals: intent, search pressure, price elasticity, and supply friction.

2) Use Cases

OTA / Marketplace

Decide which destinations to promote next month, not last quarter
Allocate marketing spend based on forecasted ROI
Detect overheating markets before conversion drops

Destination & Tourism Boards

Quantify inbound demand by source market
Identify emerging destinations early
Support infrastructure and capacity planning

3) Signal Inputs (What the model actually sees)

Search and browse intent (normalized, anonymized)
Flight, hotel, and activity availability pressure
Price movement & elasticity indicators
Seasonality & event calendars
Macro signals (visa rules, advisories, connectivity changes)

Each signal is timestamped and weighted by predictive power, not volume.

4) Demand Forecasting Model

Demand is forecasted as a distribution, not a single number. This enables safe automation.

Output	Description	Usage
P50 Demand	Median expected demand	Baseline planning
P90 Demand	High-confidence upper bound	Capacity stress testing
Forecast Confidence	Stability of signals	Automation vs review decision

5) Market Opportunity Scoring

Opportunity score answers one question: “If I invest here now, will returns improve?”


opportunity_score =
  demand_growth_rate
- supply_growth_rate
+ margin_potential
- volatility_penalty
- regulatory_friction

Scores are comparable across destinations and time windows.

6) Trend Detection

Early vs Late trends

Early: intent rising, prices stable → invest early
Mid: prices rising, capacity tightening → monetize
Late: volatility, cancellations → throttle

Spyface flags trend phase so teams don’t overreact too late.

7) Endpoints

Method	Endpoint	Purpose
POST	/v1/markets/forecast	Demand forecast by destination
POST	/v1/markets/opportunity	Compute opportunity scores
POST	/v1/markets/trends	Detect emerging or fading trends
POST	/v1/events	Send realized outcomes for calibration

8) Sample Schema

{
  "request_id":"req_market_001",
  "destination":{
    "type":"CITY",
    "code":"BCN",
    "country":"ES"
  },
  "time_window":{
    "start":"2026-05-01",
    "end":"2026-06-30"
  },
  "source_markets":["US","DE","UK"]
}

9) Code Example (Python)


import os, requests

resp = requests.post(
  "https://api.spyface.com/v1/markets/opportunity",
  headers={
    "Authorization": f"Bearer {os.environ['SPYFACE_API_KEY']}",
    "Content-Type": "application/json"
  },
  json={
    "request_id":"req_market_001",
    "destination":{"type":"CITY","code":"BCN"},
    "window":{"start":"2026-05-01","end":"2026-06-30"}
  }
)

data = resp.json()
print("Opportunity score:", data["opportunity_score"])
print("Phase:", data["trend_phase"])

10) Operational Integration

High-leverage integrations

Feed opportunity score into campaign bidding
Auto-adjust supply onboarding targets
Trigger alerts when forecast confidence drops

This API is designed to sit upstream of pricing, marketing, and inventory systems.

Why this beats “market reports”

APIs, not PDFs
Probabilities, not opinions
Decisions, not dashboards

For advanced integration or benchmarks: hello@spyface.com