peerspace.com APIpeerspace.com ↗
Search Peerspace venue listings by location and activity type. Get pricing, ratings, capacity, amenities, host details, and equipment via 6 endpoints.
curl -X GET 'https://api.parse.bot/scraper/5e6cabbc-af8d-4f35-989b-8bba59612c57/search_listings?pages=1&activity=meeting' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Peerspace listings by activity type and location. Returns paginated results with listing summaries including pricing, ratings, capacity, and availability.
| Param | Type | Description |
|---|---|---|
| bbox | string | Bounding box coordinates in format [lat1,lng1,lat2,lng2]. |
| pages | integer | Number of pages to fetch (24 results per page). |
| activity | string | Activity type slug (e.g. 'party', 'meeting', 'photo-shoot'). Use get_activity_suggestions to discover valid values. |
| place_id | string | Google Place ID for location. Use get_location_suggestions to find valid place IDs. |
| start_page | integer | Starting page number. |
{
"type": "object",
"fields": {
"results": "array of listing summary objects with listing_id, listing_name, price_per_hour, rating_value, review_count, capacity, and more",
"total_count": "integer total number of matching listings"
},
"sample": {
"data": {
"results": [
{
"city": "New York",
"state": "NY",
"host_id": "56912f532de21d0700da93a5",
"capacity": 30,
"currency": "USD",
"categories": [
"Event"
],
"listing_id": "6135985b8c75a3000c3728dc",
"listing_url": "https://www.peerspace.com/pages/listings/6135985b8c75a3000c3728dc",
"square_feet": 0,
"amenity_tags": [
"byof",
"photo_studio",
"speakers"
],
"listing_name": "Event Space with iconic city view",
"neighborhood": "Midtown Manhattan",
"rating_value": 4.96,
"review_count": 416,
"price_per_hour": 125,
"first_image_url": "https://res.cloudinary.com/peerspace-inc/image/upload/q_80,c_crop,g_custom/w_420,h_260,c_fill/hcbazi1jvpchv8i87q7b",
"upcoming_availability": [
{
"key_range": {
"end": "2026-05-30T22:00",
"start": "2026-05-30T18:00"
}
}
]
}
],
"total_count": 2127
},
"status": "success"
}
}About the peerspace.com 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.
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.
- 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 | 250 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.