# Rate shopping for your comp set, 330 nights at a time

> Pull forward rate calendars for every hotel in a competitive set, queue the whole set as one job, and receive a signed webhook when the rates are ready.

Canonical page: https://scrapercompany.com/use-cases/competitor-rate-shopping. Built for: Revenue managers, Hotel groups, Pricing-engine builders, Hospitality consultants.

## The problem

Revenue decisions run on what the comp set will charge, night by night, months out. Rate-shopping tools sell that as a screen. If your pricing engine, BI stack or product needs the numbers, you need them as data.

Fetching one night per request makes a 90-night horizon 90 requests per competitor. A calendar returns the whole horizon at once, with base, taxes, fees and total kept apart so the numbers compare cleanly.

## How it works

1. **Resolve each competitor.** Find each hotel once by name and city and store its Google property token. Endpoint: [`POST /v1/search`](https://scrapercompany.com/docs/reference/search), 2 credits.
2. **Queue the comp set.** Submit up to 50 properties in one job with an idempotency key. The job is stored before the API answers and survives restarts. Endpoint: [`POST /v1/jobs`](https://scrapercompany.com/docs/reference/jobs-create), from 8 credits.
3. **Collect the calendars.** Poll the job, or pass a callback URL and receive a signed webhook when it finishes. Each item is a forward calendar of up to 330 nights. Endpoint: [`GET /v1/jobs/{job_id}`](https://scrapercompany.com/docs/reference/jobs-get), free.
4. **Load and compare.** Every rate row says when and how it was observed, so day-over-day changes are traceable in your warehouse.

## What you get back

- **Nightly rates**: up to 330 nights per hotel per call, 90 by default
- **Price parts**: base, taxes, fees and total kept apart on every night
- **Provenance**: when and how each rate was observed
- **Webhooks**: a signed callback when a comp-set job finishes

## Worked example (illustrative)

A revenue manager tracks 8 competitors for the next 90 nights, every morning.

- Calendar job item, 8 hotels × 90 nights: 8 calls a day × 8 credits = 64 credits a day
- About 1,920 credits a month (30 days)

Pricing: free trial of 50 calls or 14 days, whichever ends first, no card needed; Starter $49/month for 40,000 credits; Growth $149/month for 150,000 credits; Scale $399/month for 500,000 credits; Business $999/month for 1,500,000 credits; credit packs $15 for 7,500, $60 for 35,000, $200 for 125,000 (valid 12 months). Failed requests (4xx or 5xx) and empty results cost 0 credits. https://scrapercompany.com/pricing

## FAQ

### How far ahead can I see rates?

One calendar call returns up to 330 nights for one hotel (90 by default), for 8 credits.

### How many hotels fit in one job?

Up to 50. Each succeeded item is billed like a single calendar call; submitting and polling the job are free.

### What if a night has no price?

Nights with no bookable price are listed in unpriced_dates, and coverage gives the share of nights that priced. A calendar where no night priced, such as a closed property, is not charged.

### Can I retry safely after a timeout?

Yes. Every job submission carries an Idempotency-Key header. Reusing a key with the same body returns the original job instead of starting a new one.

## Read next

- [Guide: monitor a comp set with jobs and webhooks](https://scrapercompany.com/docs/guides/monitor-comp-set)
- [Guide: price a hotel's next 90 nights](https://scrapercompany.com/docs/guides/price-next-90-nights)
- [Hotel price API](https://scrapercompany.com/hotel-price-api)
- [Google Hotels API](https://scrapercompany.com/google-hotels-api)
- [Pricing and credits](https://scrapercompany.com/pricing)
