{
  "openapi": "3.0.1",
  "info": {
    "title": "Eventbrite Scraper — New Event Alerts",
    "description": "Search Eventbrite by city, category or keyword — title, start/end with timezone, when the event was listed, venue, category and tags; recurring series as one record. Monitoring mode delivers only newly listed events. $0.01 per event, no start fee.",
    "version": "0.0",
    "x-build-id": "388K7D9Tqkk6WwBJd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/magnova~eventbrite-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-magnova-eventbrite-scraper",
        "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/magnova~eventbrite-scraper/runs": {
      "post": {
        "operationId": "runs-sync-magnova-eventbrite-scraper",
        "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/magnova~eventbrite-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-magnova-eventbrite-scraper",
        "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": {
          "destinationUrls": {
            "title": "Destination URLs (optional)",
            "type": "array",
            "description": "Eventbrite destination (browse) page URLs to read, exactly as you would paste them from the site — for example \"https://www.eventbrite.com/d/united-states--new-york/music/\". A URL carries its own city, category, date and price facets with it; the run-level category / keyword / date-window inputs apply to Cities entries, not to URLs. Each URL is one destination; pagination is handled for you.",
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "Cities (e.g. \"New York, United States\")",
            "type": "array",
            "description": "Cities to browse, one per entry, written as \"City, Country\" (e.g. \"New York, United States\", \"London, United Kingdom\"). A bare city name uses the run-level Country input. Use \"Online\" for Eventbrite's online-events destination. The run-level category, keyword, date window and free/online switches apply to every city. Leave empty when you use Destination URLs instead.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country (for bare city names)",
            "type": "string",
            "description": "Optional run-level country applied to Cities entries written as a bare city name (e.g. city \"Austin\" + country \"United States\"). Entries written as \"City, Country\" carry their own country and ignore this."
          },
          "category": {
            "title": "Category (optional — empty = all)",
            "type": "string",
            "description": "Optional Eventbrite category to browse in each city, by its destination name — e.g. \"music\", \"business\", \"food and drink\", \"arts\", \"health\", \"nightlife\", \"community\", \"sports and fitness\". It becomes part of the destination page address, so it must be a category Eventbrite itself uses; an unrecognised category makes that destination return an ERROR record instead of guessing. Leave empty to browse all categories."
          },
          "keyword": {
            "title": "Keyword (optional)",
            "type": "string",
            "description": "Optional keyword search (e.g. \"jazz\", \"startup mixer\"). With no category set, the keyword runs as Eventbrite's own destination search. With a category also set, the category is browsed and the keyword filters the results by title, description and tags. Leave empty for all events in the destination."
          },
          "dateWindow": {
            "title": "Date window",
            "enum": [
              "upcoming",
              "today",
              "tomorrow",
              "this_weekend",
              "custom"
            ],
            "type": "string",
            "description": "Which events to include by their start date. \"upcoming\" = everything Eventbrite lists (destination pages show upcoming events only), \"today\", \"tomorrow\" and \"this_weekend\" use Eventbrite's own date facets, and \"custom\" keeps events starting between Date from and Date to (enforced on each event's own start date; a custom run reads deeper into the destination because the match can sit anywhere in Eventbrite's ranking)."
          },
          "dateFrom": {
            "title": "Date from (custom window)",
            "type": "string",
            "description": "Custom window start (ISO date, e.g. \"2026-11-14\"). Only applies when the date window is \"custom\"; must be given together with Date to."
          },
          "dateTo": {
            "title": "Date to (custom window)",
            "type": "string",
            "description": "Custom window end (ISO date, e.g. \"2026-11-30\"). Only applies when the date window is \"custom\". Maximum window: 366 days."
          },
          "freeOnly": {
            "title": "Free events only",
            "type": "boolean",
            "description": "On: browse Eventbrite's free-events destinations instead — the free facet is part of the destination address. Applies to Cities entries; destination URLs carry their own facets (use a free-events URL there)."
          },
          "onlineOnly": {
            "title": "Online events only",
            "type": "boolean",
            "description": "On: only online events are delivered (in-person events are skipped, never charged). Works for every destination, including URLs. For Eventbrite's dedicated online destination, add \"Online\" as a city instead — or in addition."
          },
          "listedSince": {
            "title": "Listed on/after (stateless cursor)",
            "type": "string",
            "description": "Optional stateless cursor for workflow tools (Make, Zapier, your own scheduler) that hold state themselves: only events LISTED on Eventbrite at or after this moment are delivered — for example \"2026-11-01\" (a date means the start of that day, UTC) or \"2026-11-01T12:00:00Z\". The check runs on every event's own listed timestamp (listedAt), boundary-inclusive, so nothing older than the cursor is ever delivered or charged. Destination pages rank by relevance rather than listing date, so a cursor run still reads the destination's pages — it filters, it does not narrow the read. Leave empty for no cursor."
          },
          "monitorOnlyNew": {
            "title": "Start monitoring silently (skip the first baseline)",
            "type": "boolean",
            "description": "Off (default): the first run delivers the destinations' current events as a baseline batch (charged), later runs deliver only new ones. On: the first run silently remembers the current events without delivering or charging anything, and only events listed afterwards are ever delivered. Only applies when a monitor store is selected; without a store every run is a baseline run."
          },
          "monitorStore": {
            "title": "Monitor state store (for only-new delivery)",
            "type": "string",
            "description": "A key-value store this Actor may read and write to remember which events it has already seen — this is what makes only-new delivery work across runs. Pick any store you own; the Actor keeps one small state record in it. A recurring series is remembered by its series, so its next instance does not re-alert. Without a store, every run delivers the destinations' events as a baseline and remembers nothing. If the store is missing or cannot be opened, the run continues in baseline mode and the SUMMARY record says so — it never crashes. The Actor remembers every event it processed (including filtered-out ones), so widening your filters later does not re-deliver old events."
          },
          "maxResults": {
            "title": "Maximum events per run",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on events delivered (and charged) in one run, across all destinations in the run. Eventbrite serves at most about 1,000 deduplicated events per destination, so several destinations (or narrower filters) reach deeper corpora. Events a capped run could not deliver stay unseen in monitoring mode and are delivered by the next run if they still match."
          },
          "maxTotalChargeUsd": {
            "title": "Maximum total charge per run (USD)",
            "minimum": 0.01,
            "type": "number",
            "description": "Optional hard stop for this run's charges: delivery stops as soon as the charged events reach this amount (checked conservatively at the highest per-event price, so the run may stop slightly early on discounted tiers), and the SUMMARY record reports stoppedByMaxCharge. Undelivered new events stay unseen, so the next run delivers them. Leave empty for no cap. The run-level maximum charge in the run options is also honoured exactly."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}