Pitchup APIpitchup.com ↗
Search campsites, check real-time availability and pricing, read reviews, and list pitch types from Pitchup.com via a structured JSON API.
What is the Pitchup API?
The Pitchup.com API covers 9 endpoints for searching, inspecting, and comparing campsites listed on Pitchup.com. The search_campsites endpoint returns rated campsite listings with lead prices and coordinates filtered by location, date range, and pitch type. Other endpoints expose per-day pricing calendars, paginated user reviews with category-level ratings, nearby sites with distances, and full contact details including GPS coordinates.
curl -X GET 'https://api.parse.bot/scraper/0b399b4f-583c-4f0b-b7b8-981db90b7e1a/search_campsites?page=1&sort=magic&country=GB&location=Cornwall&pitch_types=tent&adults_count=2&arrival_date=2026-07-22&departure_date=2026-07-25' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace pitchup-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Pitchup.com SDK — search campsites, check reviews and availability."""
from parse_apis.pitchup_com_api import Pitchup, CampsiteSort, CampsiteNotFound
client = Pitchup()
# Search campsites in Cornwall sorted by rating, cap at 5 results
for site in client.campsites.search(location="Cornwall", country="GB", sort=CampsiteSort.RATING, limit=5):
print(site.name, site.rating, site.hierarchy_text)
# Fetch full contact details for one campsite
campsite = client.campsites.get(slug="monkey-tree-holiday-park")
print(campsite.name, campsite.postcode, campsite.latitude, campsite.longitude)
# Browse reviews for that campsite
for review in campsite.reviews.list(limit=3):
print(review.user.username, review.rate_overall, review.liked[:60])
# List nearby campsites with distance info
for nearby in campsite.nearby.list(limit=3):
print(nearby.name, nearby.distance.km, nearby.is_bookable)
# Check pitch type availability calendar
avail_cal = client.pitchtypeavailabilities.get(slug="monkey-tree-holiday-park")
print(avail_cal.availability_calendar)
# Check booking availability for a pitch type
avail = client.bookingavailabilities.check(
pitchtype_id="10214",
arrival_date="2026-07-01",
departure_date="2026-07-05",
)
print(avail.pitchtype_id, avail.window.start, avail.window.end)
# Handle a campsite that doesn't exist
try:
client.campsites.get(slug="nonexistent-campsite-xyz")
except CampsiteNotFound as exc:
print(f"Not found: {exc.slug}")
print("exercised: campsites.search / campsites.get / reviews.list / nearby.list / pitchtypeavailabilities.get / bookingavailabilities.check")
Search for campsites by location, dates, and other filters. Returns a paginated list of campsites with basic info, ratings, and lead prices. Results are enriched with detail data (name, hierarchy, photos) via a secondary per-result lookup. Without a location, returns all bookable campsites globally.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number. |
| sort | string | Sort order for results. |
| country | string | Country ISO code (e.g. 'GB'). |
| location | string | Location name or search query (e.g. 'Cornwall', 'Lake District'). |
| pitch_types | string | Filter by pitch types (e.g. 'tent', 'caravan', 'motorhome'). |
| adults_count | integer | Number of adults. |
| arrival_date | string | Arrival date in YYYY-MM-DD format. |
| departure_date | string | Departure date in YYYY-MM-DD format. |
{
"type": "object",
"fields": {
"page": "string current page number",
"count": "integer total matching campsites",
"results": "array of campsite objects with id, slug, name, rating, rateCount, lead_price, point, hierarchyText, and primaryPhoto"
}
}About the Pitchup API
Search and Discovery
The search_campsites endpoint accepts location, country, arrival_date, departure_date, pitch_types, and adults_count parameters and returns a paginated list of campsite objects. Each result includes id, slug, name, rating, lead_price, point (coordinates), and photo metadata. Results can be sorted by magic, price, or rating. The companion get_search_filters_metadata endpoint returns available filter facets — facet_category, facet_hierarchy, and facet_facet_keywords — along with their document counts, which is useful for building filter UIs or understanding coverage across location hierarchies.
Campsite Detail and Pitch Types
get_campsite_details accepts either a short campsite slug (e.g. monkey-tree-holiday-park) or a full hierarchical path and returns the complete SSR payload for that campsite page via the nuxt_raw_data field. get_campsite_pitch_types returns an availability_calendar array with per-date available_pitchtype_ids and bookable_dates, plus the full Nuxt SSR payload. Once you have a pitchtype_id, pass it to get_booking_availability along with arrival_date and departure_date to get a calendar_data object keyed by date, containing per-day pricing, availability status, and bookable departure options.
Reviews and Ratings
get_campsite_reviews returns paginated review objects for a given slug. Each review includes per-category star ratings, review text, user metadata, and visit date. The ratings field in the response provides aggregate averages across rating dimensions, and the summary object includes the percentage of reviewers who would recommend or revisit the site. The sort parameter (e.g. -visit_date) controls ordering.
Listing and Contact Data
list_all_campsites supports bulk retrieval of up to 500 campsites per page, filterable by country and bookable_only. Each record includes address, postcode, coordinates, rating, and the Pitchup URL. get_campsite_contact_info provides the same fields for a single site by campsite_id or slug. Email addresses are not available through either endpoint — Pitchup routes all communication through its own platform. get_campsite_nearby_sites returns nearby campsites with distance, lead_price, and basic info for a given slug.
The Pitchup API is a managed, monitored endpoint for pitchup.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pitchup.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official pitchup.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a campsite comparison tool using
search_campsiteslead prices andget_campsite_reviewsaggregate ratings across multiple sites. - Populate a real-time availability widget using
get_booking_availabilitycalendar_data with per-day pricing for a specific pitch type. - Generate a bulk campsite directory with GPS coordinates and postcodes from
list_all_campsitesfiltered by country. - Find alternative sites near a fully-booked campsite using
get_campsite_nearby_siteswith distance and pricing data. - Analyze seasonal pricing trends by querying
get_booking_availabilityacross a date window for a given pitchtype_id. - Filter campsite searches by pitch type (tent, caravan, motorhome) and guest count using
search_campsitesparameters. - Build a review sentiment dashboard using
get_campsite_reviewsper-category rating averages and recommend/revisit percentages.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Pitchup.com have an official developer API?+
What does get_booking_availability return, and how granular is the pricing data?+
calendar_data object keyed by individual dates within the requested window. Each date entry includes pricing, availability status, and the set of bookable departure dates from that arrival. You need a pitchtype_id (available from get_campsite_pitch_types) along with arrival_date and departure_date to make the request.Are campsite email addresses available through this API?+
list_all_campsites and get_campsite_contact_info explicitly return null for the email field. Pitchup routes all owner-guest communication through its own platform. Phone numbers are also not currently exposed. The API does return address, postcode, GPS coordinates, and the Pitchup URL for each site. You can fork this API on Parse and revise it to add any additional contact fields if they become accessible.Can I retrieve individual campsite photos or a full image gallery?+
search_campsites, but a dedicated endpoint for full image galleries is not currently included. The API covers search results, detail pages, reviews, availability, and pitch types. You can fork it on Parse and revise to add a gallery-specific endpoint.How does pagination work across the listing endpoints?+
list_all_campsites accepts page (starting at 1) and limit (up to 500) parameters and returns total_count and total_pages in every response. search_campsites and get_campsite_reviews also accept a page parameter and return count and num_pages respectively, so you can iterate through full result sets programmatically.