# Posh Events (`aitorsm/posh-events`) Actor Scrape events, organizers, tickets, RSVPs, and full organizer profiles (email, Instagram, LinkedIn, website, Stripe Connect ID) from Posh.vip. Built for lead generation, sponsorship targeting, and competitive market intelligence in the US nightlife and social-events space. - **URL**: https://apify.com/aitorsm/posh-events.md - **Developed by:** [Aitor Sanchez-Mansilla](https://apify.com/aitorsm) (community) - **Categories:** Lead generation, Automation, Travel - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $30.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Posh Events Scraper - Discover Events, Organizers, and Tickets for Lead Generation, Outreach, and Market Intelligence [![Posh Events Scraper status](https://apify.com/actor-badge?actor=aitorsm/posh-events)](https://apify.com/aitorsm/posh-events) The **Posh Events Scraper** allows you to efficiently extract event data from [Posh](https://posh.vip) — the US-focused social-events and nightlife platform used by independent throwers, hospitality groups, and brand activations. It returns detailed, structured information for every event, including: - Event name, short description, start/end times, and timezone - Full venue address with GeoJSON coordinates - **Complete ticket tier breakdown** — name, price, fees, hidden flag, sold-out flag, approval-required flag, free RSVP vs paid tiers - **Live RSVP counts** via the `attending[]` array (length = confirmed attendees) - **Organizer profile** — name, slug, avatar, verified flag, currency, Stripe Connect account ID, and (in organizer mode) **contact email + social handles + lifetime attendee count** - Per-event lineup, bottle-service tables, and full markdown description (organizer mode) - Geographic metadata for filtering by city, region, or country With a **user-friendly visual input**, this tool is built for sales teams, sponsorship platforms, recruiters, and marketing agencies who need fast, reliable access to Posh's organizer ecosystem. ### Use Cases #### 1. **Organizer Lead Generation** Identify the most active throwers in NYC, LA, Miami, DC, Boston, or Atlanta. Pull their full organizer profile in one pass — including email, Instagram, X / Twitter, LinkedIn, website, and Stripe Connect account ID. No follow-up enrichment step required. #### 2. **Revenue-Based Ranking** Every event includes `tickets[]` (full tier prices), `attending[]` (live RSVPs), and `groupNumOfAttendees` (organizer lifetime total). Multiply price × RSVP count × event frequency to estimate organizer revenue and prioritize outreach. #### 3. **Sponsorship Targeting** Filter for verified organizers (`groupVerified: true`) and high-traffic events. The `groupContactEmail` field gives you a direct line for sponsorship inquiries — exposed at the group level, no scraping the website needed. #### 4. **Recruiting Hosts, DJs, and Promoters** Organizer mode returns every event for a thrower with the `lineup[]` array attached — DJ name, photo, and Instagram link for every performer. Perfect for talent scouting, creator partnerships, or booking. #### 5. **Competitive and Market Intelligence** Track how often competitors run events, what they charge, which venues they book, and how their RSVPs trend. Run the scraper on a schedule and diff the output over time to spot momentum and price shifts. #### 6. **Event Aggregation for Local Newsletters and Apps** Pull a clean, structured feed of upcoming nightlife / cultural events for a US city and republish it on your "What's On" newsletter, tourism board, hotel concierge, or coworking-space app. #### 7. **Lead Enrichment for Existing Lists** Already have a list of organizer slugs from `posh.vip/g/` URLs? Use organizer mode to pull every event they've ever run (past and future) along with their full profile — great for enriching outbound prospect lists. #### 8. **Cross-Platform Organizer Database** Combine Posh data with Eventbrite, Luma, or Meetup datasets to build a unified, multi-source organizer database. Shared fields (name, social handles, website, city) make deduplication straightforward. #### 9. **Stripe Connect Discovery** Every event exposes the organizer's `groupConnectId` (Stripe Connect account). Useful for payments-stack market intelligence, B2B targeting of Stripe-integrated merchants, and tracking platform adoption. > **Coming soon:** per-event live ticket availability and remaining-seat counts, per-event guestlist with attendee names and Instagram-verified flags, custom date-range filtering. [Drop me a line](mailto:business@aitorsm.com) if any of these would unblock a use case for you — it helps me prioritize. ### Cost This Actor uses pay-per-event pricing with tiered rates: - **No subscription** - $0.03 per Event Scraped Apify's platform costs are included, so the total amount is totally predictable for you. ### Input The input is designed around two search modes, picked via the **`searchType`** dropdown. Fill in only the field(s) your chosen mode needs. - **`searchType`** — pick one: - `city` — return every upcoming event in a city, sorted by Trending / Newest / Largest. - `organizer` — return every event from one organizer, past and future. - **`city`** — one of Posh's 6 preset US cities (`New York City`, `Los Angeles`, `Washington DC`, `Boston`, `Atlanta`, `Miami`) or `custom`. Posh's traction is concentrated in these US markets; international cities typically return very few local events. - **`customCityName`** / **`customLatitude`** / **`customLongitude`** — only when `city = "custom"`. Provide a label (any string) and the city's center coordinates (e.g. San Francisco: lat 37.7749, long -122.4194). Posh has light coverage in San Francisco, Chicago, Brooklyn, Austin, Seattle, San Diego, and Toronto. - **`organizer`** — the slug from `posh.vip/g/` (e.g. `blavity-inc` from `posh.vip/g/blavity-inc`). Required when searchType is `organizer`. - **`sort`** — for city mode: `Trending` (default), `Newest`, or `Largest`. - **`when`** — for city mode: `Today`, `This Week`, `This Month` (default), or `Right Now`. Custom date ranges aren't currently supported; if you need finer slicing, pick `This Month` and filter by `startUtc` in your downstream pipeline. - **`keywords`** — for city mode: free-text search applied to the events feed. Leave blank to return everything. - **`priceMaxBucket`** — for city mode: optional. Filter to events with at least one visible ticket priced up to `Free`, `$20`, `$50`, `$100`, `$200`, or any price. - **`maxItems`** — optional cap on how many events to return. Leave blank to fetch everything available. Feel free to reach out if you need more advanced filtering options! ### Output The data is returned in **JSON format**, ideal for direct ingestion into analytics platforms, CRMs, dashboards, or downstream pipelines. The two modes return different shapes — organizer mode is significantly richer than city mode (with full description, lineup, and organizer-level contact data). Both real examples below. #### City mode — example entry Input: `{ "searchType": "city", "city": "Los Angeles", "when": "This Month", "maxItems": 1 }` ```json { "_id": "6a0729e064d4536354e499c5", "event_page_url": "https://posh.vip/the-black-ragebait-economy", "name": "The Black Rage-bait Economy", "shortDescription": "Who profits from Black rage online?", "url": "the-black-ragebait-economy", "flyer": "https://images.posh.vip/originals/6a075ce08e2e921dd9f06011", "flyerBlurHash": "dgM#LnWV+us:{2ofr?aex:snSgaxrKWBWVj[=XbbX8WV", "startUtc": "2026-05-20T19:00:00.000Z", "endUtc": "2026-05-20T19:30:00.000Z", "timezone": "America/Los_Angeles", "venue": { "name": "", "address": "The location will be revealed on the event date.", "images": [] }, "location": { "type": "Point", "coordinates": [-118.242643, 34.0549076] }, "isLocationHiddenUntilEventDate": true, "accentColor": "#96625c", "eventTitleFont": "NHGDisplay-Bold", "guestlistEnabled": true, "lightmode": false, "tickets": [ { "id": "6a0729e064d4536354e499c7", "name": "RSVP", "price": 0, "totalPrice": 0, "quantityAvailable": 9999999, "isAvailable": true, "closed": false, "isHidden": false, "priceHidden": false, "disabled": false, "approvalRequired": false, "isTransferable": true, "availableForSaleVia": ["event_page", "tap_to_pay"], "tags": [] } ], "attending": [ "65cbe29240ad6c1951d48284", "6719cceaeb26f1293e27c1c2", "692047ada81d81bea30c154e", "...(29 more attendee IDs)" ], "soldOutItems": [], "fees": [], "paymentPlans": [], "videos": [], "groupID": "6750a1fe236d9fc869444ddf", "groupName": "Blavity, Inc.", "groupUrl": "blavity-inc", "groupAvi": "https://images.posh.vip/alts/67941cfe982d64a0cbffddeb/600x600.png", "groupType": "hospitalityGroup", "groupCurrency": "USD", "groupConnectId": "acct_1QSNUQRgRj5CUUMM", "groupVerified": true, "groupCuratorFees": [ { "name": "Service Fee", "type": "percent", "amount": 0.05, "applyTo": "subtotal", "limitedToId": [], "_id": "69dd328b542e45aae538855c" } ], "groupPoshFees": { "subtotalFee": 0.08 } } ```` #### Organizer mode — example entry (much richer) Input: `{ "searchType": "organizer", "organizer": "blavity-inc", "maxItems": 1 }` ```json { "id": "67734fae8d62005fe3c970e5", "event_page_url": "https://posh.vip/bmg-music-awards-social", "url": "bmg-music-awards-social", "name": "BMG Music Awards Social", "shortDescription": "Celebrate music's biggest night with Blavity Media Group.", "description": "Join **Blavity Media Group** on **February 1st** for a day of luxe and glam in Los Angeles. The **BMG Music Awards Social,** sponsored by **Nissan** is an opulent AM-to-PM occasion where elegance meets artistry...\n\nDJ sets by **DJ JADABOO | DJ Meel | Benjamin Walker | Jae Murphy**\n\nSpecial Guest **BOBBY V**...", "flyer": "https://images.posh.vip/alts/67940be0afbef639d0782bc2/1400x1750.webp", "startUtc": "2025-02-01T22:00:00.000Z", "endUtc": "2025-02-02T03:00:00.000Z", "start": "2025-02-01T14:00:00.000Z", "end": "2025-02-01T19:00:00.000Z", "timezone": "America/Los_Angeles", "displayEndTime": true, "multiDayDisplay": false, "venue": { "name": "Hyde Sunset Kitchen + Cocktails", "address": "8117 W Sunset Blvd, Los Angeles, CA 90046, USA", "images": [ "https://images.posh.vip/originals/67855e746838e53180c2a298", "https://images.posh.vip/originals/67855e746838e53180c2a284", "https://images.posh.vip/originals/67855e746838e53180c2a28d" ] }, "lineup": [ { "name": "Bobby V", "avi": "https://images.posh.vip/originals/67941ebc982d64a0cb013151", "link": "https://www.instagram.com/bobbyvshow?igsh=NTc4MTIwNjQ2YQ==", "_id": "679bacce2db14d48f54665c9" }, { "name": "DJ JADABOO", "avi": "https://images.posh.vip/originals/67941dbe982d64a0cb001472", "link": "https://www.instagram.com/jadab0o?igsh=NTc4MTIwNjQ2YQ==", "_id": "679bacce2db14d48f54665ca" }, { "name": "DJ Meel", "avi": "https://images.posh.vip/originals/67941e5e982d64a0cb011eff", "link": "https://www.instagram.com/djmeel?igsh=NTc4MTIwNjQ2YQ==", "_id": "679bacce2db14d48f54665cc" } ], "performanceCategory": "Lineup", "tables": [], "ticketGroups": [], "paymentPlans": [], "promoCodes": true, "passwordProtected": false, "hasPasswordProtectedTickets": false, "isRSVPEvent": false, "isApprovalOnlyRSVPEvent": false, "isAttendee": false, "isAwaitingApproval": false, "isPersonalEvent": false, "guestlistEnabled": false, "attendanceDisplayDisabled": true, "attending": ["1"], "displayOnThirdPartySites": true, "activityEnabled": false, "galleryID": "67a28d144e3440eeddb3b763", "youtubeLink": null, "song": { "albumCover": "https://i.scdn.co/image/ab67616d000048514a055aa41b2fdec14da6bac2", "previewLink": "https://p.scdn.co/mp3-preview/34afe4679f07cf8b09d26b90f6ff10ccd96dbe99", "link": "https://open.spotify.com/track/5fJcHhfW0ngZ4qGZqJrIQh", "name": "Anonymous - Main", "artist": "Bobby V." }, "accentColor": "#ffffff", "lightmode": false, "eventTitleFont": "Inter-Bold", "status": "live", "termsOfService": "**Photography & Likeness**\n\nBy attending this event, you hereby consent to be photographed, filmed and/or otherwise recorded...", "groupID": "6750a1fe236d9fc869444ddf", "groupName": "Blavity, Inc.", "groupUrl": "blavity-inc", "groupAvi": "https://images.posh.vip/alts/67941cfe982d64a0cbffddeb/600x600.png", "displayGroupName": "Blavity, Inc.", "displayGroupImage": "https://images.posh.vip/alts/67941cfe982d64a0cbffddeb/600x600.png", "groupCurrency": "USD", "groupVerified": true, "groupContactEmail": "events@blavity.com", "groupSocials": { "instagram": "blavity", "twitter": "blavity", "website": "https://blavity.com/", "linkedIn": "https://www.linkedin.com/company/afrotechbrand/" }, "groupBio": "Blavity events include the following sub brands; AFROTECH™, AI Edge, HealthStack, THE MEETUP networking event series, AfroTech Insider, Blavity House Party, Home & Texture, Travel Noire and 21Ninety...", "groupLinks": [ { "title": "AFROTECH™", "url": "https://afrotechconference.com/" }, { "title": "AfroTech Insider", "url": "https://afrotech.com/insider" }, { "title": "Travel Noire App", "url": "https://travelnoire.com/app" } ], "groupNumOfAttendees": 24074, "groupCountry": "US", "groupCreatedAt": "2024-12-04T18:40:00.773Z" } ``` > Heads up — both modes share most core fields (event basics, venue, geo, tickets, attending, organizer ID/name/socials). The per-event detail fields (`description`, `lineup`, `tables`, `ticketGroups`, `termsOfService`) and the organizer-level contact fields (`groupContactEmail`, `groupSocials`, `groupBio`, `groupNumOfAttendees`) are only returned when you query a specific organizer. #### Fields Shared between both modes: - **Event name and description** — `name`, `shortDescription`, plus a flyer image URL and accent color. - **Dates and timezone** — `startUtc` and `endUtc` (ISO 8601 UTC) plus the local `timezone`. - **Venue and geography** — full venue object (name, address, images) plus `location.coordinates` (GeoJSON `[longitude, latitude]`). - **Tickets** — `tickets[]` array with **every tier** including `name`, `price`, `totalPrice` (price + fees), `description`, `isAvailable`, `closed`, `priceHidden`, `approvalRequired`. Free RSVP and paid tiers both included. - **Live attendance** — `attending[]` (array of attendee user IDs; `.length` = confirmed RSVPs). Strong "popularity now" signal. - **Organizer basics** — `groupID`, `groupName`, `groupUrl`, `groupAvi`, `groupType`, `groupCurrency`, `groupVerified`, **`groupConnectId`** (Stripe Connect account ID). Organizer mode adds: - Full `description` (markdown), `lineup[]` (DJs/hosts with photos + Instagram), `tables[]` (bottle service), `ticketGroups[]`, `termsOfService`, `song` (Spotify track on the event page). - Organizer-level: `groupContactEmail`, `groupSocials` (Instagram / Twitter / website / LinkedIn), `groupBio`, `groupLinks`, `groupNumOfAttendees` (lifetime). #### Simplified Overview A simplified view of this data will be shown directly in the **Apify console**, where you can see a table of key event details including organizer, date, venue, ticket tiers, and RSVP count. ```json { "name": "The Black Rage-bait Economy", "startUtc": "2026-05-20T19:00:00.000Z", "venue.address": "The location will be revealed on the event date.", "groupName": "Blavity, Inc.", "groupVerified": true, "tickets": "1 tier (Free RSVP)", "attending": "32 RSVPs", "event_page_url": "https://posh.vip/the-black-ragebait-economy" } ``` *** ### How to Use 1. **Pick a search mode**: choose `city` or `organizer` from the **searchType** dropdown. 2. **Fill in the required field(s)**: e.g. `city: "New York City"` for a city search, or `organizer: "blavity-inc"` to pull every event from one organizer. 3. **Run the Actor**: start the scraping process. Check the Overview and All Fields tabs to inspect results as they arrive. 4. **Export Data**: once the run is complete, export the dataset in JSON, CSV, Excel, or HTML — directly into your CRM, spreadsheet, dashboard, or pipeline. *** Start scraping Posh events today by running this Actor on Apify. ### Contact - **Email**: — for custom features, advanced filtering, tailored data products, or anything off-spec. - **Apify Discord**: find me as `aitor.sm`. If this actor has been useful to you, please consider adding it to your bookmarks 📑 on Apify. # Actor input Schema ## `searchType` (type: `string`): Pick how you want to discover events. ## `city` (type: `string`): Posh-supported city. Pick a preset (covers Posh's biggest US markets) or use 'custom' and fill in the latitude/longitude below. Posh's traction is concentrated in US East Coast + LA + Miami; Toronto has light coverage; international cities (London, Berlin, Tokyo) typically return 0 local events. ## `customCityName` (type: `string`): Free-text city label. The browser uses the Google Places formatted name (e.g. 'San Francisco, CA, USA') but any string works — it's cosmetic. ## `customLatitude` (type: `number`): Latitude of the city center. E.g. 37.7749 for San Francisco. ## `customLongitude` (type: `number`): Longitude of the city center. E.g. -122.4194 for San Francisco. ## `organizer` (type: `string`): The organizer's slug from the URL (e.g. 'blavity-inc' from posh.vip/g/blavity-inc). Required when searchType is 'organizer'. ## `sort` (type: `string`): How the events feed is ranked. ## `when` (type: `string`): Posh's API only exposes these four buckets — no custom date range. For finer filtering, pick the broadest one ('This Month') and filter by event.startUtc downstream. ## `keywords` (type: `string`): Free-text search applied to the events feed. Leave blank to return everything. ## `priceMaxBucket` (type: `string`): Filter to events with at least one visible ticket up to this bucket. Hidden in the production UI but supported by the API. ## `maxItems` (type: `integer`): Leave blank to fetch all available. ## Actor input object example ```json { "searchType": "city", "city": "Los Angeles", "sort": "Trending", "when": "This Month", "keywords": "", "priceMaxBucket": "", "maxItems": 10 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("aitorsm/posh-events").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10 } # Run the Actor and wait for it to finish run = client.actor("aitorsm/posh-events").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10 }' | apify call aitorsm/posh-events --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=aitorsm/posh-events", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Posh Events", "description": "Scrape events, organizers, tickets, RSVPs, and full organizer profiles (email, Instagram, LinkedIn, website, Stripe Connect ID) from Posh.vip. Built for lead generation, sponsorship targeting, and competitive market intelligence in the US nightlife and social-events space.", "version": "0.1", "x-build-id": "kAxCXPhPam9TQ6nz5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aitorsm~posh-events/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aitorsm-posh-events", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/aitorsm~posh-events/runs": { "post": { "operationId": "runs-sync-aitorsm-posh-events", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/aitorsm~posh-events/run-sync": { "post": { "operationId": "run-sync-aitorsm-posh-events", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "searchType" ], "properties": { "searchType": { "title": "What to search", "enum": [ "city", "organizer" ], "type": "string", "description": "Pick how you want to discover events.", "default": "city" }, "city": { "title": "City", "enum": [ "New York City", "Los Angeles", "Washington DC", "Boston", "Atlanta", "Miami", "custom" ], "type": "string", "description": "Posh-supported city. Pick a preset (covers Posh's biggest US markets) or use 'custom' and fill in the latitude/longitude below. Posh's traction is concentrated in US East Coast + LA + Miami; Toronto has light coverage; international cities (London, Berlin, Tokyo) typically return 0 local events.", "default": "Los Angeles" }, "customCityName": { "title": "Custom city name (only if city = 'custom')", "type": "string", "description": "Free-text city label. The browser uses the Google Places formatted name (e.g. 'San Francisco, CA, USA') but any string works — it's cosmetic." }, "customLatitude": { "title": "Custom latitude (only if city = 'custom')", "minimum": -90, "maximum": 90, "type": "number", "description": "Latitude of the city center. E.g. 37.7749 for San Francisco." }, "customLongitude": { "title": "Custom longitude (only if city = 'custom')", "minimum": -180, "maximum": 180, "type": "number", "description": "Longitude of the city center. E.g. -122.4194 for San Francisco." }, "organizer": { "title": "Organizer slug", "type": "string", "description": "The organizer's slug from the URL (e.g. 'blavity-inc' from posh.vip/g/blavity-inc). Required when searchType is 'organizer'." }, "sort": { "title": "Sort (city mode only)", "enum": [ "Trending", "Newest", "Largest" ], "type": "string", "description": "How the events feed is ranked.", "default": "Trending" }, "when": { "title": "Time window (city mode only)", "enum": [ "Today", "This Week", "This Month", "Right Now" ], "type": "string", "description": "Posh's API only exposes these four buckets — no custom date range. For finer filtering, pick the broadest one ('This Month') and filter by event.startUtc downstream.", "default": "This Month" }, "keywords": { "title": "Keywords (city mode only)", "type": "string", "description": "Free-text search applied to the events feed. Leave blank to return everything.", "default": "" }, "priceMaxBucket": { "title": "Max price bucket (city mode only)", "enum": [ "", "0", "20", "50", "100", "200", "infinity" ], "type": "string", "description": "Filter to events with at least one visible ticket up to this bucket. Hidden in the production UI but supported by the API.", "default": "" }, "maxItems": { "title": "Max events to return", "minimum": 1, "type": "integer", "description": "Leave blank to fetch all available." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```