Quick Start

Make your first API request in under 5 minutes.

Step 1: Get Your API Key

Go to scrapercompany.com/login
Sign up (it takes 60 seconds)
Navigate to your dashboard
Copy your API key (starts with sk_)

Free tier includes: 1,000 successful requests, 2 concurrent requests, all features unlocked.

Step 2: Search for a Property Token

First, find the Google property token for the hotel you want to monitor. You'll use this token in subsequent requests:

cURL

curl -X POST "https://api.scrapercompany.com/v1/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hilton Chicago",
    "city": "Chicago",
    "market": "US"
  }'

Python

import requests
import os

API_KEY = os.environ.get("SCRAPERCOMPANY_API_KEY")
BASE_URL = "https://api.scrapercompany.com"

headers = {
    "x-api-key": API_KEY,
    "Content-Type": "application/json"
}

# Search for property
response = requests.post(
    f"{BASE_URL}/v1/search",
    headers=headers,
    json={"name": "Hilton Chicago", "city": "Chicago", "market": "US"}
)

data = response.json()
token = data["recommended_match"]["token"]
print(f"Property token: {token}")

JavaScript (Node.js)

const axios = require('axios');

const API_KEY = process.env.SCRAPERCOMPANY_API_KEY;
const BASE_URL = 'https://api.scrapercompany.com';

const headers = {
  'x-api-key': API_KEY,
  'Content-Type': 'application/json'
};

// Search for property
axios.post(`${BASE_URL}/v1/search`, {
  name: 'Hilton Chicago',
  city: 'Chicago',
  market: 'US'
}, { headers })
  .then(response => {
    const token = response.data.recommended_match.token;
    console.log(`Property token: ${token}`);
  })
  .catch(error => {
    console.error(error);
  });

Step 3: Get 90-Night Calendar Rates

Now use the token to fetch a 90-night rate calendar in a single request:

curl -X POST "https://api.scrapercompany.com/v1/calendar" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "days": 90,
    "currency": "USD",
    "market": "US"
  }'

Step 4: Understand the Response

You'll receive a JSON response with structured rate data for each night:

{
  "priced": [
    {
      "stay_date": "2026-10-01",
      "rate_base": 249.00,
      "tax": 24.90,
      "fees": 0.0,
      "rate_total": 273.90,
      "min_length_of_stay": 1
    },
    {
      "stay_date": "2026-10-02",
      "rate_base": 269.00,
      "tax": 26.90,
      "fees": 0.0,
      "rate_total": 295.90,
      "min_length_of_stay": 1
    }
  ],
  "coverage_pct": 95.6,
  "meta": {
    "property_token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "currency": "USD",
    "market": "US"
  }
}

Next Steps

Authentication

Learn more about API key authentication and security best practices.

Learn more

API Endpoints

Explore all available endpoints and their parameters.

View endpoints

Tip: Store your API key in environment variables, never commit it to version control.