{ "openapi": "3.0.1", "info": { "title": "Fever Scraper - Events, Prices, Venues & Dates", "description": "Scrape Fever events by city, category, keyword or URL. Extract from-prices, venues, dates and ratings, with optional enrichment for event descriptions, venue addresses and available sessions.", "version": "0.1", "x-build-id": "55qGHfxpEFSwyW1s0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~fever-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-fever-com-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/abotapi~fever-com-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-fever-com-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/abotapi~fever-com-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-fever-com-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to start the scrape. 'search' walks city catalogues. 'url' processes the Fever URLs you paste: an event URL is fetched as a single event, and a city or category URL is read like a search, its own city and category deciding the scope. The filters below apply to every walk in both modes; a pasted event URL is the one exception and returns that single event in full.", "default": "search" }, "cities": { "title": "Cities", "type": "array", "description": "City slugs to browse, for example 'new-york', 'london', 'madrid', 'paris', 'milan', 'sao-paulo'. Each city is scraped independently. Search mode only: in URL mode the scope is read out of each pasted URL instead. Defaults to New York when empty. Plain names ('New York', 'London') and Fever codes (NYC, LON) are accepted; an unreadable name fails the run loudly.", "default": [ "new-york" ], "items": { "type": "string" } }, "queryType": { "title": "Query type (alias)", "enum": [ "browse", "event" ], "type": "string", "description": "Alias for Mode using the vocabulary of other Fever scrapers: 'browse' means mode 'search', 'event' means reading the single event in 'Event ID'. Leave empty to use Mode." }, "city": { "title": "City (alias)", "type": "string", "description": "Single city as a name, slug or Fever code (LON, NYC, PAR). In search mode it replaces the Cities list, so only this city is scraped." }, "locale": { "title": "Language", "enum": [ "en", "es", "fr", "it", "pt", "de" ], "type": "string", "description": "The site language prefix for city pages: en, es, fr, it, pt or de. Unknown values fall back to en. Search mode only: in URL mode the pasted URL carries its own language.", "default": "en" }, "category": { "title": "Category (optional)", "type": "string", "description": "Narrow every city walk to one category slug, for example 'candlelight', 'music-events', 'exhibitions' or 'food'. Leave empty to browse the whole city catalogue. Search mode only: in URL mode a pasted category URL decides its own scope." }, "query": { "title": "Keyword filter (optional)", "type": "string", "description": "Only keep events whose title or categories contain this text, for example 'candlelight' or 'jazz'. The site has no keyword parameter, so it is applied to the rows this run reads. Search mode only: in URL mode the pasted URL decides its own scope." }, "urls": { "title": "Fever URLs", "type": "array", "description": "Paste event URLs (https://feverup.com/m/653922), city URLs (https://feverup.com/en/new-york) or category URLs (https://feverup.com/en/london/candlelight). A pasted URL decides its own scope. The price bounds below narrow what the walks read; a pasted event URL is the exception and returns that single event in full. Trailing slashes, a www host, other locales (en, es, fr, it, pt, de) and tracking or ?page query strings are accepted (the query is ignored). Locale-only pages (/en), nested category paths and /en/m/ID are not supported and log a per-URL warning.", "default": [ "https://feverup.com/en/new-york", "https://www.feverup.com/en/london", "https://feverup.com/es/madrid", "https://feverup.com/en/new-york/candlelight", "https://feverup.com/en/london/music-events", "https://feverup.com/m/653922" ], "items": { "type": "string" } }, "id": { "title": "Event ID (alias)", "type": "string", "description": "Numeric Fever event ID, for example 653922. Reads that single event in full, like pasting https://feverup.com/m/653922. When it is filled, only this event is read: the Mode and Fever URLs fields (including the sample URL list) are ignored. Set Query type to 'browse' to ignore the ID and browse by city instead." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only keep events whose from-price is at least this amount, in the row's own currency. The site has no parameter for this, so it is applied to the rows this run reads. Applies to every walk in both modes; a pasted event URL is the exception and returns that single event in full." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only keep events whose from-price is at most this amount, in the row's own currency. The site has no parameter for this, so it is applied to the rows this run reads. Applies to every walk in both modes; a pasted event URL is the exception and returns that single event in full." }, "fetchDetails": { "title": "Fetch event details", "type": "boolean", "description": "Fetch each event's page for the description, the venue address with coordinates, the categories, the session dates and the ticket availability. Slower, and charged once per record. Leave off for a fast crawl: identity, from-price, venue, dates and rating are included either way.", "default": false }, "maxReviewsPerEvent": { "title": "Guest reviews per event", "minimum": 0, "maximum": 500, "type": "integer", "description": "With Fetch event details on, attach up to this many of the newest guest reviews (reviewer, rating, date, text, helpful votes) to each event, following the site's own pages. 0 turns reviews off. Capped at 500 per event. Reviews add no separate fee.", "default": 20 }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "The single cap on this run: stop after collecting this many records across all cities and URLs. A listing page serves what the site renders in one read (city pages render the catalogue; category pages serve a capped window per grid with the rest behind the site's Load more control), so there is no page cap. Set 0 for unlimited.", "default": 20 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Leave the default for the cheapest run. The site serves ordinary shared connections, so the default pool is enough. Change it only if a run reports that it could not read any results.", "default": { "useApifyProxy": true } }, "resumeFromRunId": { "title": "Resume from a previous run", "type": "string", "description": "Paste a previous run ID or dataset ID to continue a large crawl without returning or charging for records already collected there. Use this after an interrupted or capped run. For recurring monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or weekly recurring monitoring of the same search, for example a price watch. The first run returns everything matching as NEW. Later runs normally return only NEW, UPDATED and REAPPEARED records. COMPARED between runs: every returned field (price from, original price, on-sale flag, discount, currency, dates, venue, description, categories, tickets available and the rest). EXCLUDED because they drift without the event changing: rating, rating count, image URL, scrape time and the carried-forward marker; they are still returned. Price moves and new dates ARE reported as UPDATED: on an events catalogue they are the signal, not noise. To react only to price and availability, set Change scope to price and availability. Turn on Emit unchanged or Emit expired only when you also want those rows returned (and billed). State is kept separately per city, URL and filter setup; use State key to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Leave empty to let the actor derive a key automatically from the cities, URLs and filters, so two different searches never mix state." }, "emitUnchanged": { "title": "Emit unchanged records (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return records that have not changed since the last run, marked UNCHANGED. This returns, and bills, extra rows you already have, so leave it off unless you specifically want a full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired records (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return records that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search: not when Max items capped it, not when Resume was used, not when the run was refused, and not when a category page served a capped window of its catalogue (the run says Partial results instead). This returns, and bills, extra synthetic rows, so leave it off unless you need expiry tracking.", "default": false }, "changeScope": { "title": "Change scope (incremental mode only)", "enum": [ "all", "priceAndStock" ], "type": "string", "description": "All fields (default): any change in a returned field makes a record UPDATED. Price and availability: only price, original price, on-sale flag, discount, currency and tickets available decide UPDATED; description, venue, dates and artwork changes never create a billable row. Rows are still returned in full.", "default": "all" }, "compactUpdates": { "title": "Compact UPDATED rows (incremental mode only)", "type": "boolean", "description": "Off by default. When on, UPDATED rows carry only the event id, URL, title, current price fields and a priceChanges object with old and new values. The event-page details fee is not charged for a compact row because the fields it covers are not in the row. NEW rows stay full.", "default": false }, "expireAfterMissedScans": { "title": "Expire after N missed scans (incremental mode only)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Used only with Emit expired. A record is marked EXPIRED only after it is missing from this many CONSECUTIVE complete scans (default 1). EXPIRED means the event dropped out of the listing, which can be a sell-out, an ended run or a ranking change; it is not proof the event is unavailable.", "default": 1 }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Field names that never decide UPDATED and never appear in changedFields, for example description or venueName. They are still returned in the row. Rating, rating count and image URL are always ignored. Dotted paths like sessions.image drop that key inside every element of a list.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API and Integrations, then select it here. Notion gets a page per record; other connectors get a best-effort write or digest. Each connector receives a condensed summary per record, not the full record; the complete record always stays in the dataset. Leave empty to skip; this never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which record pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on records written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }