Event / peak-date demand radar
Watch supply and prices around an event or peak date-window in a city and get alerted when demand tightens.
What it does
The job it gets done
Around a concert, conference or holiday weekend, accommodation supply tightens and prices climb — and the window to react is short. This radar scans the market for a city and date-window on a schedule (GET /v1/search), tracks the available-listing count and median price against the previous run, deep-checks a bellwether listing’s availability and cross-OTA price, and alerts when supply drops or prices rise beyond your thresholds — a pricing-opportunity signal for hosts and an early demand read for investors.
How it works
Step by step
- 1
Set the city, the event window and thresholds
Give the radar the city, the event check-in / check-out, the platforms to scan, and the supply-drop / price-rise percentages that should trigger an alert.
- 2
Scan the market on a schedule
Each run calls GET /v1/search for the city and dates across platforms, returning the currently-available supply and each listing’s price.
- 3
Deep-check a bellwether listing
It picks a representative listing and calls GET /v1/availability (how many dates are still open) and GET /v1/price-compare (its cross-OTA min / median) for a precise read on the window.
- 4
Alert on tightening supply or rising prices
A Code node diffs this run’s supply and median price against the previous run (stored in n8n static data) and posts an alert to Slack only when either crosses your threshold — swap for email or Telegram.
What you'll need
Two ways to run it
Using an AI agent
Just your ScoutingAPI key. Your agent is the brain — it calls the endpoint and reports the result itself, so there's no separate AI key to buy. Install the SKILL.md below.
Using n8n
A running n8n instance, the workflow JSON below, a ScoutingAPI Header Auth credential, and a delivery credential (e.g. Slack) — or swap the last node. The transform is plain JavaScript, so no LLM key is required.
Try it live
Run the core call now — sandbox, 0 credits
Exercise the endpoint this workflow is built on against the deterministic sandbox — a real 200, zero credits, no sign-up.
/v1/searchRuns against the deterministic Airbnb + Booking sandbox fixtures — a real 200, zero credits.
Run the call to see a live, deterministic sandbox response.
curl -sS "https://api.scoutingapi.com/v1/search" \
-H "Authorization: Bearer $SCOUTINGAPI_KEY"Code samples
The same call, every way that matters
# Scan the market for the event window…
curl -sS "https://api.scoutingapi.com/v1/search?location=Split,HR&checkIn=2026-07-13&checkOut=2026-07-20&platforms=airbnb,booking&limit=40" \
-H "Authorization: Bearer $SCOUTINGAPI_KEY"
# …then compare a bellwether property's cross-OTA price
curl -sS "https://api.scoutingapi.com/v1/price-compare?name=Hotel%20X%20Split&location=Split,HR&checkIn=2026-07-13&checkOut=2026-07-20" \
-H "Authorization: Bearer $SCOUTINGAPI_KEY"Get it for your platform
Download & import
Open source (MIT) — view on GitHub ↗
Typical cost
from 5 credits per platform per run — scales with the results returned (v3 per-result).
search· from 5 credits per platformavailability· from 5 credits per callprice-compare· 22 credits per call
Failed & empty calls are always free; sandbox calls cost 0. Live costs are on the pricing page.
FAQ
Common questions
Get your free key — no card
300 credits, the full API, the sandbox, and the native MCP server. Power this workflow and more.
No credit card · failed calls cost 0 credits