Theme-park ticket calendar API reference

Name the park by park id (from GET /v1/attractions/parks) or by its website url. Each date has a status (open, closed, sold_out, or unavailable when the park's shop lists nothing for it), the headline price (the cheapest adult or one-price day ticket; free tickets never count), availability where the park shows it, and every ticket with price, price_before_tax, tax and list_price (the gate or undiscounted price). summary.cheapest_dates lists the lowest priced open dates. Prices are in the park's own currency.

With include_capacity, each date also carries capacity: the park's daily capacity (total), tickets sold (sold), remaining and percent_available, each only where the park's shop states it (null otherwise, and the whole object null for parks that show none).

Request

POSThttps://api.scrapercompany.com/v1/attractions/calendar

Authenticate with your API key in the x-api-key header (see Authentication).

Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.

Body

JSON object. Unknown fields are rejected with 422.

parkstring | nullpattern ^[a-z0-9-]{2,60}$
Park id from GET /v1/attractions/parks, e.g. dollywood or alton-towers.
urlstring | nullmax length 500
The park's website or ticket-shop URL, instead of park. Parks sharing one site are told apart by path (https://www.sixflags.com/knotts).
start_datestring (date) | null
First visit date, YYYY-MM-DD; defaults to today where the park is.
daysintegerdefault 31min 1, max 92
Visit dates to return from start_date, 1 to 92. Each started 31 days is billed separately.
include_capacitybooleandefault false
Also return each date's capacity numbers (daily capacity, tickets sold, remaining, percent available) where the park's shop states them. Only for parks whose capacity is true in GET /v1/attractions/parks (others answer 422, free). Adds 2 credits per started 31 days.

Example request

curl -X POST "https://api.scrapercompany.com/v1/attractions/calendar" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "park": "dollywood",
    "days": 31
  }'

Response

200 — Ticket calendar for one park (7 days). Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

200 response

{
  "search_parameters": {
    "engine": "attractions_calendar",
    "park": "parc-asterix",
    "start_date": "2027-02-07",
    "end_date": "2027-02-13"
  },
  "park": {
    "id": "parc-asterix",
    "name": "Parc Astérix",
    "operator": "Compagnie des Alpes",
    "country": "FR",
    "timezone": "Europe/Paris",
    "currency": "EUR",
    "website": "https://www.parcasterix.fr",
    "capacity": false
  },
  "calendar": [
    {
      "date": "2027-02-07",
      "status": "open",
      "price": 49,
      "currency": "EUR",
      "tickets": [
        {
          "name": "Single tariff",
          "visitor_type": "any",
          "price": 49,
          "currency": "EUR",
          "product_id": "TPAD1BIN0391"
        }
      ]
    },
    {
      "date": "2027-02-08",
      "status": "unavailable",
      "tickets": []
    }
  ],
  "summary": {
    "open_days": 2,
    "closed_days": 0,
    "sold_out_days": 0,
    "unavailable_days": 5,
    "min_price": 49,
    "max_price": 59,
    "cheapest_dates": [
      "2027-02-07",
      "2027-02-13"
    ]
  },
  "meta": {
    "source": "official_site",
    "price_basis": "online_price_as_listed",
    "elapsed_s": 0.21
  }
}

Arrays are shortened to their first items.

Errors

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

Status	Meaning	Retry?
`401`Unauthorized	Missing or invalid API key. `{"detail":"missing or invalid API key"}`	No, fix the request
`402`Payment Required	Not enough credits for this request: the account's credits mode is `enforce` (`mode` in `GET /v1/billing`) and the request costs more than the available credits. Nothing is run or charged. `{"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."}`	No, fix the request
`404`Not Found	The property, stay, job or record was not found. `{"detail":"job not found"}`	No, fix the request
`422`Unprocessable Content	Request validation failed. `detail` is a list of problems for schema errors, or a string for semantic checks performed by the endpoint. `{"detail":[{"loc":["body","name"],"msg":"Field required","type":"missing"}]}`	No, fix the request
`429`Too Many Requests	Too many requests: the key's requests-per-minute limit was exceeded, or (in `enforce` credits mode) the plan's concurrent-request limit. No rate-limit or Retry-After headers are sent; back off and retry. `{"detail":"rate limit 60/min exceeded"}`	Yes, with backoff
`503`Service Unavailable	Temporarily unavailable: a dependency of this endpoint is down, or the upstream source changed its contract. Retry later. `{"detail":"database unavailable: OperationalError"}`	Yes, with backoff

Try it

Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.

Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? start a free trial).
Copy the cURL example above and run it in a terminal.

Credits

4 credits per successful call (4 per started 31 days, plus 2 per started 31 days with include_capacity (a calendar with no priced date, an unknown park and failed requests are free)). Failed, blocked and empty results are free.

Request#

Body#

Example request#

Response#

Errors#

Try it#