Peerspace APIpeerspace.com ↗
Search Peerspace venue listings by location and activity type. Get pricing, ratings, capacity, amenities, host details, and equipment via 6 endpoints.
What is the Peerspace API?
The Peerspace API exposes 6 endpoints for searching and inspecting venue listings across Peerspace.com. The search_listings endpoint returns paginated results with price per hour, rating, review count, and capacity for each venue. Companion endpoints cover full listing detail — including amenities, equipment, host name, and social links — plus activity autocomplete, location suggestions via Google Places, and available search filters categorized by space type, style, and features.
curl -X GET 'https://api.parse.bot/scraper/5e6cabbc-af8d-4f35-989b-8bba59612c57/search_listings?bbox=%5B40.917705%2C-74.258843%2C40.476578%2C-73.700169%5D&pages=1&activity=party&place_id=ChIJOwg_06VPwokRYv534QaPC8g&start_page=1' \ -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 peerspace-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.
from parse_apis.peerspace_api import Peerspace, Listing, ListingDetail, Activity, Location, FilterSet
peerspace = Peerspace()
# Search for locations to get a place_id
for location in peerspace.locations.search(query="Los Angeles"):
print(location.place_id, location.description, location.main_text)
break
# Search for activity types
for activity in peerspace.activities.search(query="photo"):
print(activity.id, activity.dropdown, activity.rank)
# Search listings for parties in New York
for listing in peerspace.listings.search(activity="party", place_id="ChIJOwg_06VPwokRYv534QaPC8g", limit=5):
print(listing.listing_name, listing.price_per_hour, listing.rating_value, listing.capacity)
# Get detail for this listing
detail = listing.detail.get()
print(detail.host_name, detail.description)
# Get search filters for an activity
filters = peerspace.filtersets.get_filters(activity="meeting")
for space_type in filters.space_types:
print(space_type.canonical_id, space_type.display_name)
# Crawl enriched listings
for enriched in peerspace.enrichedlistings.crawl(activity="meeting", pages=1, limit=3):
print(enriched.listing_name, enriched.host_name, enriched.price_per_hour)
Search for Peerspace listings by activity type and location. Returns paginated results with listing summaries including pricing, ratings, capacity, and availability. Each page contains up to 24 results. Requires a place_id (from get_location_suggestions) and an activity slug (from get_activity_suggestions) to produce meaningful results.
| Param | Type | Description |
|---|---|---|
| bbox | string | Bounding box coordinates as a JSON array string in format [lat1,lng1,lat2,lng2]. |
| pages | integer | Number of pages to fetch (24 results per page). |
| activity | string | Activity type slug such as 'party', 'meeting', 'photo-shoot'. Discover valid values via get_activity_suggestions. |
| place_id | string | Google Place ID for location filtering. Obtain from get_location_suggestions. |
| start_page | integer | Starting page number (1-based). |
{
"type": "object",
"fields": {
"results": "array of listing summary objects",
"total_count": "integer total number of matching listings"
},
"sample": {
"data": {
"results": [
{
"city": "New York",
"state": "NY",
"host_id": "56912f532de21d0700da93a5",
"capacity": 75,
"currency": "USD",
"categories": [
"Event"
],
"listing_id": "645aa0a5613cb2000e25a94b",
"listing_url": "https://www.peerspace.com/pages/listings/645aa0a5613cb2000e25a94b",
"square_feet": 0,
"amenity_tags": [
"byof",
"photo_studio",
"live_music_friendly"
],
"listing_name": "LARGE EVENT SPACE IN MIDTOWN WEST",
"neighborhood": "Midtown Manhattan",
"rating_value": 4.93,
"review_count": 97,
"price_per_hour": 175,
"first_image_url": "https://res.cloudinary.com/peerspace-inc/image/upload/q_80,c_crop,g_custom/w_420,h_260,c_fill/ckdy6chtpkeejdehcgvm",
"upcoming_availability": [
{
"key_range": {
"end": "2026-06-13T22:00",
"start": "2026-06-13T18:00"
}
}
]
}
],
"total_count": 2105
},
"status": "success"
}
}About the Peerspace API
Search and Filter Listings
The search_listings endpoint accepts a place_id (a Google Place ID), an activity slug such as party, meeting, or photo-shoot, and an optional bounding box via the bbox parameter for geographic scoping. Results come back 24 per page; use pages and start_page to paginate. Each result object includes listing_id, listing_name, price_per_hour, rating_value, review_count, and capacity. To discover valid activity slugs before querying, call get_activity_suggestions with an optional query string — it returns objects with id, display_keyword, use_type, and rank. For valid place_id values, use get_location_suggestions with a city or neighborhood string.
Listing Detail and Host Data
get_listing_detail accepts a listing_id from search results and returns the full listing record: description, rules, opening_hours, address_full, host_name, amenities (as canonical IDs), equipment (as detected keywords), and social_links with keys for instagram, facebook, twitter, youtube, tiktok, and website. This makes it possible to cross-reference a venue's social presence alongside its physical details.
Bulk Crawl and Filter Discovery
crawl_all_listings combines search and detail extraction in a single call. Supply an activity slug and a pages count; the endpoint returns a flat array of enriched listing objects suitable for direct CSV export, including listing_url, host_profile_url, currency, and the full detail fields. For filtering, get_search_filters accepts an activity slug and returns categorized arrays — space_types, amenities, styles, indoor_features, outdoor_features, production_features, and ranked_space_types with sort_rank and cloudinary_id — giving a complete picture of available refinement options for any activity context.
The Peerspace API is a managed, monitored endpoint for peerspace.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when peerspace.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 peerspace.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 venue comparison tool that surfaces price_per_hour, capacity, and rating_value side-by-side for a given city.
- Aggregate host social profiles using the social_links fields to identify venue operators with large Instagram or TikTok followings.
- Map venue density across a metro area using bbox search and listing coordinates.
- Generate a structured dataset of film and photo-shoot spaces by crawling with the photo-shoot activity slug via crawl_all_listings.
- Populate a filtered venue directory by fetching space_types and amenities from get_search_filters and letting users narrow results.
- Monitor pricing trends for meeting spaces in specific neighborhoods using repeated search_listings queries with place_id.
- Qualify corporate event venues by filtering on capacity and equipment keywords returned by get_listing_detail.
| 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.