# Dice Events (`aitorsm/dice-events`) Actor

Collect events from DICE (dice.fm): title, date, lineup, venue, and ticket details. In venue mode each show carries a full venue lead — Instagram, website, email, phone, and capacity. Built for booking, venue lead generation, and live-music market intelligence.

- **URL**: https://apify.com/aitorsm/dice-events.md
- **Developed by:** [Aitor Sanchez-Mansilla](https://apify.com/aitorsm) (community)
- **Categories:** Automation, Lead generation, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## DICE Events Scraper — Promoters, Venues, Lineups, and Pricing for Music + Nightlife Lead Generation

[![DICE Events Scraper status](https://apify.com/actor-badge?actor=aitorsm/dice-events)](https://apify.com/aitorsm/dice-events)

The **DICE Events Scraper** extracts structured event data from [DICE](https://dice.fm) — the mobile-first ticketing platform for live music, clubs, festivals, comedy, and cultural events across 69+ cities worldwide. Each scraped event returns:

- Event name, description, start time, attendance type, sale status, and DICE event URL
- **Promoter (organizer) info** — billing promoter ID, name, and slug, plus additional marketeers
- **Full venue data** — name, full address, latitude/longitude, city, country
- **Lineup** — headliner act + supporting acts
- **Ticket pricing** — amount (minor units), currency, formatted display
- **Status signals** — `isTicketAvailable`, sold-out flag, waiting-list flag, `isTicketAvailableAtDoor`
- **Categorization** — primary tag (Gigs / DJ / Party / Festival / Comedy / Theatre / Film / etc.) plus secondary tag types
- Event flyer image URL and DICE social/share links

City targeting is URL-based (no geo-IP dependency) — the actor works for any of DICE's 69 catalog cities from any origin.

### Use Cases

#### 1. **Music Promoter Lead Generation**
DICE is where indie promoters, club nights, and festival operators sell tickets to live audiences. Every event exposes its `billingPromoter` (the org running the show) plus any additional `marketeers` (co-promoters / agencies). Pull a city's active promoter list with run-rate signals in one pass — ideal input for ticketing-platform BD, music-tech vendors, or sponsorship outreach.

#### 2. **Venue Lead Generation + Booking Intel**
Each event carries the full venue record (name, address, lat/lng). Run the `sweepVenues: true` mode to enumerate every DICE-listed venue in a city, and keep `enrichVenues: true` to turn each venue into a self-contained **lead row** — the venue's website, Instagram, Facebook, TikTok, Twitter/X, phone, email, capacity, and description, attached to every one of that venue's events. Ideal for booking agents identifying which rooms are actively programming, AV / production vendors mapping their addressable market, or anyone selling into venue operators directly.

#### 3. **Cross-Platform Organizer Database**
Combine DICE output with Eventbrite, Luma, Posh, and Meetup datasets for unified multi-source organizer intelligence. DICE skews music + nightlife; the other platforms cover broader event categories. Together they form a complete picture of who's running paid events in a city.

#### 4. **Concert + Festival Market Intelligence**
Track which acts are touring, which venues are programming them, and at what price points. The `summaryLineup` (headliner) + `lineupSupports` fields give act-level granularity; `priceAmount` + `priceCurrency` lets you compare ticket-price trends across cities or sub-genres.

#### 5. **Talent and Booking Pipeline**
For booking agencies, A&R teams, or content platforms: surface emerging acts being booked at indie venues before they show up on the big-room tour cycle.

#### 6. **Event Aggregation for Local Apps and Newsletters**
Pull a clean structured feed of upcoming music + nightlife events in a city for use in "what's on tonight" newsletters, tourism sites, hotel concierge apps, or co-working community boards.

#### 7. **Ad-Targeting and Audience Research**
Use venue addresses + event categories to inform geo-targeted ads (Meta / TikTok) at audiences with confirmed music-event affinity. Multi-platform overlap (DICE event in same building as Posh event) is a strong "active scene" indicator.

#### 8. **Competitive Tracking for Ticketing Platforms**
If you sell ticketing infrastructure, the list of promoters currently using DICE is your would-be customer list. Run weekly and diff to spot churn or growth.

> **On the roadmap**: deeper per-venue event coverage, Apple Music / Spotify track preview links, and full per-event detail enrichment. [Drop me a line](mailto:business@aitorsm.com) if any of these would unblock a use case — it helps me prioritize.

### Cost

This Actor uses **pay-per-event** pricing:
- **$0.03 per event**
- **$0.02 per unique venue enriched** — only charged when `enrichVenues` is on (the default) and only in venue-sweep mode, and only once per venue per run (deduplicated across all of that venue's events). Turn `enrichVenues` off to pay for events alone.

Apify's platform costs are included, so the total is predictable. A typical venue sweep that surfaces 60 venues with enrichment on costs roughly the per-event total plus ~$1.20 (venues) for **60 venue lead rows** carrying website, socials, phone, and email.

### Input

The actor takes a single city per run, with three escalating sweep modes for coverage depth.

- **`city`** — name of any of DICE's 69 supported cities (e.g. `"Los Angeles"`, `"London"`, `"Barcelona"`, `"Berlin"`, `"New York"`, `"Tokyo"`). Matching is fuzzy and case-insensitive.
- **`cityPermName`** / **`cityId`** *(advanced)* — DICE's internal identifiers for a city. Pass both together to target a city directly and skip name resolution. Useful if you've already resolved the city.
- **`maxItems`** — global cap on events returned (deduped across all sweep paths). Leave at the default `30` for a quick preview, or raise to thousands for a full sweep.
- **`sweepFilters`** *(boolean, default `false`)* — when true, the actor covers the city across all primary categories (Gigs / DJ / Party / Comedy / Theatre / Film / Workshop / Talk / Wellbeing / Playback / Artist signing / etc.). Yields **~3-4× more events** than the default view. Best for organizer/promoter discovery.
- **`sweepVenues`** *(boolean, default `false`)* — when true, the actor covers **every DICE venue in the city** and returns each venue's full event list. Yields the most exhaustive coverage (~10× the default), scaling with the city's venue count (e.g. 84 for LA, 163 for Barcelona). Best for event-listing use cases or maximum-coverage lead-gen. Composes with `sweepFilters` — all events deduped by ID.
- **`enrichVenues`** *(boolean, default `true`)* — when on (in `sweepVenues` mode), each venue contributes its contact + social block — `venueWebsite`, `venueInstagram`, `venueFacebook`, `venueTiktok`, `venueTwitter`, `venuePhone`, `venueEmail` — plus `venueCapacity`, `venueDescription`, and the venue's address. These fields are attached to every one of that venue's events. **Recommended for venue lead-generation** — it's what turns a venue listing into a contactable lead. Billed once per unique venue ($0.02, deduplicated). Has no effect unless `sweepVenues` is also on; turn it off to omit the contact/social fields and pay for events alone.

#### Sample inputs

**Quick city preview** (~30 events):
```json
{ "city": "Los Angeles", "maxItems": 30 }
````

**Promoter lead-gen sweep** (~130 events, ~40 promoters):

```json
{ "city": "Los Angeles", "maxItems": 1000, "sweepFilters": true }
```

**Venue lead-gen sweep** (every LA venue with website + socials + phone + email):

```json
{ "city": "Los Angeles", "maxItems": 10000, "sweepVenues": true, "enrichVenues": true }
```

**Maximum-coverage sweep** (~420 events, ~55 promoters for LA):

```json
{ "city": "Los Angeles", "maxItems": 10000, "sweepFilters": true, "sweepVenues": true }
```

### Output

The data is returned in **JSON format**, ideal for direct ingestion into analytics platforms, CRMs, dashboards, or downstream pipelines.

#### Example entry

Input: `{ "city": "Barcelona", "maxItems": 1 }`

```json
{
  "eventId": "6a06e30b1d609200016c1160",
  "permName": "mx9oqr-churros-con-chocolate-antichurros-special-pride-night-sbado-18th-jul-sala-apolo-barcelona-tickets",
  "url": "https://dice.fm/event/6a06e30b1d609200016c1160-mx9oqr-churros-con-chocolate-antichurros-special-pride-night-sbado-18th-jul-sala-apolo-barcelona-tickets",
  "name": "CHURROS CON CHOCOLATE / ANTICHURROS - Special Pride Night (sábado)",
  "about": {
    "description": "¡No te pierdas nuestro especial PRIDE del sábado! En nuestra segunda noche de celebración del Orgullo contaremos con la fórmula CHURROS CON CHOCOLATE + ANTI...",
    "highlights": [
      { "type": "age_restriction", "title": "Para mayores de 18 años (necesario traer DNI)." }
    ]
  },
  "startUnix": 1784411940,
  "startIso": "2026-07-18T21:59:00.000Z",
  "attendanceType": "live_only",
  "status": "sold-out",
  "secondaryStatus": "waiting-list",
  "isTicketAvailable": true,
  "isTicketAvailableAtDoor": false,
  "hasMultipleTicketTypes": false,
  "priceAmount": 2425,
  "priceCurrency": "EUR",
  "priceDisplay": null,
  "billingPromoterId": "4679",
  "billingPromoterName": "CHURROS CON CHOCOLATE",
  "billingPromoterPermName": "churros-con-chocolate-7289",
  "marketeers": [
    { "id": 525, "name": "Sala Apolo" },
    { "id": 843, "name": "PUMALU2 (CHURROS CON CHOCOLATE)" }
  ],
  "summaryLineup": null,
  "lineupSupports": [],
  "eventTag": null,
  "tagsTypes": [
    { "name": "party", "value": "music:party", "title": "Party" }
  ],
  "venueId": "3008",
  "venueName": "SALA APOLO",
  "venueCity": "Barcelona",
  "venueCityId": "5d8cefe1e3e6e374e99e8cbe",
  "venueCountry": "Spain",
  "venueAddress": "Carrer Nou de la Rambla, 113, 08004 Barcelona, Spain",
  "venueLat": 41.3743117,
  "venueLon": 2.1695412999999917,
  "socialLinks": {
    "event_share": "https://link.dice.fm/Z27cee70269b?dice_id=Z27cee70269b"
  },
  "imageUrl": "https://dice-media.imgix.net/attachments/2026-05-15/dd0b4aa2-2f7f-4ca4-a4c2-523bd8c4e844.jpg?rect=0%2C432%2C2160%2C1296",
  "scrapedFromCity": "Barcelona, Spain",
  "scrapedFromCityPermName": "barcelona",
  "scrapedFromCityId": "5d8cefe1e3e6e374e99e8cbe",
  "scrapedCityNameFromPage": "Barcelona",
  "scrapedAt": "2026-05-22T21:48:40.184Z"
}
```

#### Fields

| Field | Purpose |
|---|---|
| `eventId`, `permName`, `url` | DICE event identifiers + canonical URL |
| `name`, `about` | Event title + full description (with highlights) |
| `startUnix`, `startIso` | Event start time (epoch + ISO 8601 UTC) |
| `attendanceType`, `status`, `secondaryStatus` | `live_only` / `streaming` / etc.; `live` / `sold-out` / `cancelled`; `waiting-list` etc. |
| `isTicketAvailable`, `isTicketAvailableAtDoor`, `hasMultipleTicketTypes` | Availability signals at scrape time |
| `priceAmount`, `priceCurrency`, `priceDisplay` | Ticket price (minor units), ISO currency code, formatted display string |
| `billingPromoterId`, `billingPromoterName`, `billingPromoterPermName` | The organizer running the event |
| `marketeers[]` | Additional co-promoters / agencies |
| `summaryLineup`, `lineupSupports[]` | Headliner act + supporting acts |
| `eventTag`, `tagsTypes[]` | Primary tag (Gigs/DJ/Party/etc.) + secondary classification |
| `venueId`, `venueName`, `venueAddress`, `venueLat`, `venueLon`, `venueCity`, `venueCountry` | Full venue record with geo coordinates |
| **`venueLinks`** | Venue's social block `{facebook, instagram, tiktok, twitter, website}` — present when `enrichVenues=true` (venue-sweep mode) |
| **`venueWebsite`, `venueInstagram`, `venueFacebook`, `venueTiktok`, `venueTwitter`** | Flat per-platform venue links — present when `enrichVenues=true` |
| **`venuePhone`, `venueEmail`** | Venue contact details — present when `enrichVenues=true`. The direct-contact lead payload |
| **`venueCapacity`, `venueDescription`, `venueProfileAddress`** | Venue capacity, description, and profile address — present when `enrichVenues=true` |
| `socialLinks` | DICE-hosted share + referral links |
| `imageUrl` | Event flyer (landscape preferred, square / portrait fallback) |
| `scrapedFromCity`, `scrapedFromCityPermName`, `scrapedFromCityId`, `scrapedCityNameFromPage`, `scrapedAt` | Audit metadata for the scrape itself (input city display, slug, id; city confirmed by the response; timestamp) |

#### Simplified Overview

A simplified view of this data is shown directly in the **Apify console**, where you can see a table of key event details: event name, flyer, start date, venue, city, promoter, ticket price, and availability.

```json
{
  "name": "CHURROS CON CHOCOLATE / ANTICHURROS - Special Pride Night",
  "imageUrl": "https://dice-media.imgix.net/attachments/.../flyer.jpg",
  "startIso": "2026-07-18T21:59:00.000Z",
  "venueName": "SALA APOLO",
  "venueCity": "Barcelona",
  "billingPromoterName": "CHURROS CON CHOCOLATE",
  "priceDisplay": "24,25 €",
  "isTicketAvailable": true,
  "url": "https://dice.fm/event/..."
}
```

***

### How to Use

1. **Pick a city** — type any of DICE's 69 supported city names (e.g. `"Los Angeles"`, `"Berlin"`, `"Tokyo"`).
2. **Choose your sweep mode**:
   - Default → quick preview (~30 events)
   - `sweepFilters: true` → broad category sweep (~130 events)
   - `sweepFilters + sweepVenues` → maximum coverage (~400+ events)
3. **Set `maxItems`** to cap the total budget.
4. **Run the Actor** — check the Overview tab to see events as they arrive.
5. **Export the dataset** — JSON, CSV, Excel, or HTML. Drop into your CRM, spreadsheet, dashboard, or downstream enrichment pipeline.

***

Start scraping DICE events today by running this Actor on Apify.

### Contact

- **Email**: <business@aitorsm.com> — 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

## `city` (type: `string`):

City to scrape (e.g. "Los Angeles", "London", "Barcelona"). Resolved to DICE's internal city id via the public cities API.

## `cityPermName` (type: `string`):

DICE city permanent slug (e.g. "LosAngeles", "london"). Required when also passing `cityId`. Overrides `city`.

## `cityId` (type: `string`):

DICE city ObjectId hex (24 chars). Required when also passing `cityPermName`.

## `maxItems` (type: `integer`):

Maximum number of events to return. Without sweepFilters, DICE returns up to ~30 events per city. With sweepFilters=true, up to ~400 per city.

## `sweepFilters` (type: `boolean`):

If true, the actor enqueues a separate browse pass per primary filter (Gigs/DJ/Party/Sport/Comedy/Theatre/Workshop/Art/Social/Film/Talk/Wellbeing/Playback/Artist signing). Yields ~3-4x more events per city than the default 30, at the cost of ~10 extra requests. Best for organizer/promoter discovery.

## `sweepVenues` (type: `boolean`):

If true, enumerates every venue in the city via DICE's public venues API and scrapes each venue's full event list. Yields the most exhaustive coverage (~3x more events than filter sweep) but adds 1 request per venue (e.g. 84 for LA). Best for event-listing use cases. Composes with sweepFilters — all events deduped by ID.

## `enrichVenues` (type: `boolean`):

If true, each venue visited in sweepVenues mode is enriched with its contact + social details (website, Instagram, Facebook, TikTok, Twitter/X, phone, email) plus capacity, description, and address. Billed once per unique venue ($0.02). Recommended for venue lead-generation. Has no effect unless sweepVenues is also on.

## Actor input object example

```json
{
  "city": "Los Angeles",
  "maxItems": 30,
  "sweepFilters": false,
  "sweepVenues": false,
  "enrichVenues": true
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "city": "Los Angeles",
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("aitorsm/dice-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "city": "Los Angeles",
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("aitorsm/dice-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 '{
  "city": "Los Angeles",
  "maxItems": 30
}' |
apify call aitorsm/dice-events --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=aitorsm/dice-events",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Dice Events",
        "description": "Collect events from DICE (dice.fm): title, date, lineup, venue, and ticket details. In venue mode each show carries a full venue lead — Instagram, website, email, phone, and capacity. Built for booking, venue lead generation, and live-music market intelligence.",
        "version": "0.1",
        "x-build-id": "tezbDY3MQ1XiJtNae"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/aitorsm~dice-events/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-aitorsm-dice-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~dice-events/runs": {
            "post": {
                "operationId": "runs-sync-aitorsm-dice-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~dice-events/run-sync": {
            "post": {
                "operationId": "run-sync-aitorsm-dice-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",
                "properties": {
                    "city": {
                        "title": "City",
                        "type": "string",
                        "description": "City to scrape (e.g. \"Los Angeles\", \"London\", \"Barcelona\"). Resolved to DICE's internal city id via the public cities API."
                    },
                    "cityPermName": {
                        "title": "City perm_name (advanced)",
                        "type": "string",
                        "description": "DICE city permanent slug (e.g. \"LosAngeles\", \"london\"). Required when also passing `cityId`. Overrides `city`."
                    },
                    "cityId": {
                        "title": "City ID (advanced)",
                        "type": "string",
                        "description": "DICE city ObjectId hex (24 chars). Required when also passing `cityPermName`."
                    },
                    "maxItems": {
                        "title": "Max events",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of events to return. Without sweepFilters, DICE returns up to ~30 events per city. With sweepFilters=true, up to ~400 per city.",
                        "default": 30
                    },
                    "sweepFilters": {
                        "title": "Sweep all primary filters",
                        "type": "boolean",
                        "description": "If true, the actor enqueues a separate browse pass per primary filter (Gigs/DJ/Party/Sport/Comedy/Theatre/Workshop/Art/Social/Film/Talk/Wellbeing/Playback/Artist signing). Yields ~3-4x more events per city than the default 30, at the cost of ~10 extra requests. Best for organizer/promoter discovery.",
                        "default": false
                    },
                    "sweepVenues": {
                        "title": "Sweep all venues in the city (deep mode)",
                        "type": "boolean",
                        "description": "If true, enumerates every venue in the city via DICE's public venues API and scrapes each venue's full event list. Yields the most exhaustive coverage (~3x more events than filter sweep) but adds 1 request per venue (e.g. 84 for LA). Best for event-listing use cases. Composes with sweepFilters — all events deduped by ID.",
                        "default": false
                    },
                    "enrichVenues": {
                        "title": "Enrich venues (billed per venue)",
                        "type": "boolean",
                        "description": "If true, each venue visited in sweepVenues mode is enriched with its contact + social details (website, Instagram, Facebook, TikTok, Twitter/X, phone, email) plus capacity, description, and address. Billed once per unique venue ($0.02). Recommended for venue lead-generation. Has no effect unless sweepVenues is also on.",
                        "default": true
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
