Skip to content
ScoutingAPI
Docs

Getting started

Quickstart

Zero to your first successful call in under five minutes. Grab a free key, export it, and run one request — no infrastructure, no partner application.

1 · Get a free key

Create an account — 100 credits, no credit card. On sign-up you can create two kinds of key:

  1. Sandbox keys (scout_test_…) return deterministic fixtures at zero credits and work immediately — perfect for building and CI.
  2. Live keys (scout_live_…) run real cross-platform scrapes. Live credits unlock after a one-click email verification.

Export your key

Keep the key out of source control. Set it once in your shell:
export SCOUTINGAPI_KEY="scout_test_…"

2 · Make your first call

Search for stays across two platforms at once. The same request works with a sandbox or a live key — the envelope and schema are byte-identical.

curl -sS "https://api.scoutingapi.com/v1/search?location=Split,HR&platforms=airbnb,booking&limit=5" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY"

3 · Read the response

Every response is the same three-part envelope: data (normalized to the unified schema), and meta (request id, per-platform results, credits, pagination, warnings). Learn the shape on the response envelope page.

4 · Run it here, no sign-up

The console below makes a real sandbox call from your browser — a genuine 200, zero credits. Edit the fields and run it, or paste your own key.

Try itsandbox · 0 credits · no sign-up
GET/v1/search

Runs against the deterministic Airbnb + Booking sandbox fixtures — a real 200, zero credits.

Response

Run the call to see a live, deterministic sandbox response.

Copy as curl
curl -sS "https://api.scoutingapi.com/v1/search" \
  -H "Authorization: Bearer $SCOUTINGAPI_KEY"

Next steps

Add authentication details, explore the flagship price-compare endpoint, or install the TypeScript SDK.