Property availability watch → alert
Watch a listing over a date window and get alerted the moment a wanted date becomes available.
What it does
The job it gets done
Given a known listing (or a batch) and a date window, poll day-by-day availability on a schedule and alert the instant a wanted date becomes bookable. It calls GET /v1/availability with onlyAvailable=true, flattens the returned calendar, de-dups against the previous run so you are only pinged on a real change, and posts the newly-available dates. This is the automation twin of the App’s availability-alert saved search.
How it works
Step by step
- 1
Pick the listing and the date window
Set the platform, the listing id (or a full listing URL), and the start / end dates to watch (window ≤ 365 days, not in the past).
- 2
Poll availability on a schedule
Every few hours the workflow calls GET /v1/availability with onlyAvailable=true, returning the day-by-day calendar for the listing.
- 3
Detect what newly became available
A Code node flattens the calendar to the bookable dates and compares them to the previous run (stored in n8n static data), so you are alerted only when the available set changes — no duplicate pings.
- 4
Send the availability alert
When a wanted date opens up, a message listing the newly-available dates is posted to Slack — swap the last node for email, Telegram, a webhook or Discord.
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/availabilityRuns against the deterministic Airbnb sandbox fixture — a real 200, zero credits.
Run the call to see a live, deterministic sandbox response.
curl -sS "https://api.scoutingapi.com/v1/availability" \
-H "Authorization: Bearer $SCOUTINGAPI_KEY"Code samples
The same call, every way that matters
curl -sS "https://api.scoutingapi.com/v1/availability?platform=airbnb&listingId=42307961&startDate=2026-07-13&endDate=2026-07-20&onlyAvailable=true" \
-H "Authorization: Bearer $SCOUTINGAPI_KEY"Get it for your platform
Download & import
Typical cost
from 5 credits per call per run — scales with the results returned (v3 per-result).
availability· from 5 credits per calllisting· 3 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