posh.vip APIposh.vip ↗
Access Posh.vip event listings, ticket pricing, attendee guestlists, and host profiles via API. Search by city, keyword, or event slug.
curl -X GET 'https://api.parse.bot/scraper/105167c2-d1c6-49ae-ae1f-4a032902a459/explore_events?city=Miami&sort=Trending&when=This+Month&limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Browse and discover events by city, time period, and sort order. Returns paginated results with a cursor for the next page.
| Param | Type | Description |
|---|---|---|
| city | string | City name. Accepted values: 'Los Angeles', 'Miami', 'New York City', 'Washington DC', 'Boston', 'Atlanta'. |
| sort | string | Sort order for results. Accepted value: 'Trending'. |
| when | string | Time filter. Accepted values: 'This Month', 'This Week'. |
| limit | integer | Maximum number of events to return per page. |
| cursor | string | Pagination cursor from a previous response's nextCursor field. |
{
"type": "object",
"fields": {
"result": "object containing data with events array and nextCursor for pagination"
},
"sample": {
"data": {
"result": {
"data": {
"events": [
{
"_id": "6a0266678ae195d56dc0863c",
"url": "grad-season-edition-2-la-victoria",
"name": "Grad Season Edition 2 @ La Victoria",
"venue": {
"name": "La Victoria Social Club",
"address": "28 NE 40th St, Miami, FL 33137"
},
"groupUrl": "clubtab",
"startUtc": "2026-05-15T02:00:00.000Z",
"groupName": "Clubtab"
}
],
"nextCursor": 3
}
}
},
"status": "success"
}
}About the posh.vip API
The Posh.vip API exposes 7 endpoints covering event discovery, ticket availability, attendee guestlists, and host profiles from posh.vip. The explore_events endpoint lets you browse events across six US cities with time and sort filters, while get_event_tickets returns ticket group pricing and total tickets sold for any event ID. Each endpoint is designed to work together: discover events, then drill into details, attendees, or the host behind them.
Event Discovery and Search
The explore_events endpoint accepts a city parameter (Los Angeles, Miami, New York City, Washington DC, Boston, or Atlanta), an optional sort value of 'Trending', and a when filter for 'This Week' or 'This Month'. Results come back paginated with a nextCursor field you pass to the cursor parameter on subsequent calls. The search_events endpoint works similarly but requires a query keyword and scopes results to the same supported cities.
Event Details and Ticketing
get_event_details takes a URL slug (available as the url field in explore or search results) and returns structured fields: eventId (a MongoDB ObjectID), startUtc and endUtc timestamps in ISO 8601, timezone as an IANA identifier, location with lat/lng coordinates, flyer image URL, groupUrl (the host's username slug), and groupName. The get_event_tickets endpoint uses that eventId to return a ticketGroups array with pricing details and a totalTicketsSold integer. get_event_attendees similarly accepts event_id and returns a paginated guestlist array.
Host Profiles
get_host_profile accepts a username slug (pulled from any event's groupUrl field) and returns the host object with name, currency, contactEmail, socials, url, and numOfAttendees, plus an events array of that group's listings. The search_hosts_by_city endpoint automates discovery: given a city and optional limit, it surfaces host profiles with name, username, instagram, contact_email, and their associated events — useful for building a directory of active organizers in a market without manually chaining calls.
- Aggregate trending nightlife and social events across major US cities using
explore_eventswith theTrendingsort. - Monitor ticket pricing changes for specific events by polling
get_event_ticketsand trackingticketGroupsover time. - Build a contact directory of event organizers by running
search_hosts_by_cityand extractingcontact_emailandinstagramfields. - Enrich event calendar apps with venue coordinates using the
locationlat/lng returned byget_event_details. - Analyze guestlist size and attendee demand for events by paginating through
get_event_attendeesresults. - Find all events produced by a specific promoter by calling
get_host_profilewith their username slug. - Keyword-search for themed events (e.g., 'rooftop', 'networking') in a target city via
search_events.
| 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.
Does posh.vip have an official developer API?+
What cities are supported for event discovery and host search?+
explore_events, search_events, and search_hosts_by_city endpoints currently accept six cities: Los Angeles, Miami, New York City, Washington DC, Boston, and Atlanta. Events in other cities are not currently filterable by location through these endpoints. You can fork the API on Parse and revise it to add support for additional cities if the underlying data is available.Does `get_event_attendees` return full attendee profiles, or just names?+
guestlist array. The exact fields per attendee entry depend on what the event host has collected, but the response does not expose private contact details for attendees. Detailed demographic or contact data per attendee is not currently part of the response shape. You can fork the API on Parse and revise it if you need to extend what attendee fields are captured.Can I retrieve historical or past events?+
when filter on explore_events supports 'This Week' and 'This Month', both of which target upcoming or current events. Querying for past or archived events is not currently supported by the explore or search endpoints. You can fork the API on Parse and revise it to add a past-events endpoint if that data is accessible on the source.How does pagination work across these endpoints?+
explore_events, search_events, get_event_attendees — include a nextCursor field in their response. Pass that value as the cursor parameter in your next request to retrieve the following page. When nextCursor is absent or null, you have reached the end of the result set.