# Xceed Events Scraper (`hypebridge/xceed-events-scraper`) Actor

Extracts nightlife, club and festival events from Xceed without needing an official API. For every event you can get the date and venue, age policy, line-up, and the full list of ticket tiers with prices, currency, fees and availability. It can also extract venue and artist profiles.

- **URL**: https://apify.com/hypebridge/xceed-events-scraper.md
- **Developed by:** [Hypebridge](https://apify.com/hypebridge) (community)
- **Categories:** Automation, E-commerce, Integrations
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 detailed xceed records

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Xceed Events Scraper do?

**Xceed Events Scraper** extracts nightlife, club and festival events from [Xceed](https://xceed.me) without needing an official API. For every event you can get the date and venue, age policy, line-up, and the full list of **ticket tiers with prices, currency, fees and availability**. It can also extract venue and artist profiles.

It reads only what Xceed shows publicly. It does not log in, and it never collects follower identities or any other personal data.

### Why scrape Xceed?

- **Ticket price monitoring**: track prices, fees and sell-out state for clubs and festivals across Europe.
- **Event discovery and aggregation**: feed a listings site, newsletter or recommendation engine with upcoming nights by city or country.
- **Venue and promoter research**: see which clubs run what, at what price, with which line-ups.
- **Artist tracking**: follow where an artist plays next.

### What data can Xceed Events Scraper extract?

| Field | Type | Description |
|-------|------|-------------|
| `name`, `startsAt`, `endsAt` | String | Event name and ISO 8601 start/end with the venue's UTC offset |
| `venue` | Object | Name, address, coordinates, city, country code |
| `lineup` | Array | Announced artists with profile links |
| `genres`, `vibes`, `agePolicy`, `dressCode` | Mixed | Event style and entry rules |
| `salesState` | String | Raw Xceed sales state: `onSale`, `noOffers`, `allExpired`, `oneTicket` |
| `lowestPrice`, `highestPrice`, `currency` | Number / String | Headline ticket prices in the venue's currency |
| `offers` | Array | Every ticket, guest list, bottle service and pass: price, `status`, `isSoldOut`, fees, sales window, add-ons |
| `market`, `marketSupport` | String | Country of the venue and whether it is a verified country |

Venue records add description, address, genres, facilities, gallery and upcoming events. Artist records add description, genres, streaming links and upcoming events. The full field list is in the Output tab.

### How to scrape Xceed

1. [Create a free Apify account](https://apify.com) if you don't have one.
2. Open **Xceed Events Scraper** and click **Try for free**.
3. Paste one or more Xceed URLs into **Start URLs**.
4. Set **Max events** to cap your run.
5. Turn on **Get event details and ticket offers** if you want prices and availability.
6. Click **Start** and download results from the **Dataset** tab (JSON, CSV, Excel, HTML).

#### Supported URLs

| URL | What you get |
|-----|--------------|
| `https://xceed.me/en/barcelona/events` | Upcoming events in a city |
| `https://xceed.me/` (or `https://xceed.me/it`) | Upcoming events across Spain, Italy, France, Portugal and Germany (choose one with **Country**) |
| `https://xceed.me/es/madrid/event/beer-pong-tournament-4/244134` | One event, always with full details and ticket offers |
| `https://xceed.me/en/barcelona/venue/razzmatazz` | One venue profile |
| `https://xceed.me/en/artist/amelie-lens` | One artist profile |

Language prefixes `en`, `es`, `it`, `pt`, `de`, `fr` and `ca` are accepted. The language only changes display names such as genres; prices and times do not depend on it.

#### Supported countries

Spain, Italy, France, Portugal and Germany are tested and verified. Events in other countries (for example South Africa) are returned when you paste their city or event URL, and are marked `marketSupport: "unverified"`; they are never included in homepage listings.

### How much will it cost?

Billing is per result. Basic event records (listing data), venue records and artist records cost less than detailed event records that include ticket offers. Exact prices are on the Actor's **Pricing** tab.

Set **Max events** before a large run to control spend. A full run over every supported country is roughly two thousand events.

### Input

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `startUrls` | Array | required | Xceed URLs to scrape (up to 100) |
| `maxEvents` | Number | 100 | Maximum events across all URLs (1 to 5000). Venues and artists are not counted |
| `getEventDetails` | Boolean | true | Add description, line-up, ticket offers and prices to each event; set to false for listing-only events |
| `country` | String | any | Homepage URL only: spain, italy, france, portugal or germany |
| `maxConcurrency` | Number | 5 | Parallel requests (1 to 10) |
| `debugMode` | Boolean | false | Verbose logs and saved HTML of incomplete pages |

#### Example input

```json
{
  "startUrls": [{ "url": "https://xceed.me/en/barcelona/events" }],
  "maxEvents": 50,
  "getEventDetails": true
}
```

#### Example: one country

```json
{
  "startUrls": [{ "url": "https://xceed.me/" }],
  "country": "italy",
  "maxEvents": 300
}
```

### Output

Saved to the **Dataset** tab. Download as JSON, CSV, Excel or HTML. Each record has a `type` of `event`, `venue` or `artist`.

#### Sample output

```json
{
  "type": "event",
  "url": "https://xceed.me/es/madrid/event/beer-pong-tournament-4/244134",
  "language": "es",
  "market": "ES",
  "marketSupport": "verified",
  "scrapedAt": "2026-10-03T12:00:00.000Z",
  "isDetailed": true,
  "enrichmentError": null,
  "legacyId": 244134,
  "name": "Beer Pong Tournament",
  "startsAt": "2026-10-05T21:00:00+02:00",
  "endsAt": "2026-10-06T03:00:00+02:00",
  "about": "El lunes es competición. Forma tu equipo...",
  "dressCode": "Casual",
  "agePolicy": "18+",
  "venue": {
    "name": "Hood Dogs Planet",
    "address": "C. del Príncipe, 20",
    "city": "Madrid",
    "countryCode": "ES",
    "latitude": 40.4151332,
    "longitude": -3.7004227
  },
  "currency": "EUR",
  "salesState": "onSale",
  "offersAvailable": true,
  "lowestPrice": 10,
  "highestPrice": 200,
  "priceBasis": "on_sale",
  "isFree": false,
  "offers": [
    {
      "offerType": "ticket",
      "name": "Entrada + 1 copa",
      "status": "on_sale",
      "isSalesClosed": false,
      "isSoldOut": false,
      "price": 10,
      "currency": "EUR",
      "transactionFee": 1.1
    }
  ]
}
```

### Tips

- **Prices and fees**: `price` is the tier price in `currency`. `transactionFee` and (for Italy) `presaleRight` are the raw fee values Xceed lists. No all-in total is computed because Xceed does not state whether the price already includes them.
- **Sold out vs. expired**: use each offer's `isSoldOut`. `status: "sales_closed"` means sales ended, not that the event sold out. `salesState: "noOffers"` means no tickets are listed.
- **Basic mode has no prices**: Xceed's listings do not include them. Turn on **Get event details and ticket offers**.
- **Cap vs. results**: **Max events** counts every event attempted, so an event that has been removed still uses a slot.
- **Line-up**: `lineup` is `null` when it could not be fetched, and an empty list when none is announced.

### Related event scrapers

Looking for events from other platforms or need a single unified dataset? Explore our specialized event scrapers:

| Actor | Best For | Key Data Extracted |
|---|---|---|
| [Find Events](https://apify.com/hypebridge/find-events) | **All-in-one multi-platform search** across 16+ event sources | Aggregated & deduplicated events, normalized dates, venues, pricing |
| [Eventbrite Scraper](https://apify.com/hypebridge/eventbrite-search) | Global concerts, business conferences, festivals & city life | Event search, categories, ticket tiers, performers, organizer info |
| [Luma Event Scraper](https://apify.com/hypebridge/luma-com-event-scraper) | Tech meetups, hackathons, demo days, startup & Web3 events | Hosts, guest lists, ticket tiers, venue coordinates, calendar links |
| [Meetup Scraper](https://apify.com/hypebridge/meetup-scraper-all-urls) | Local community groups, networking, hobbies & recurring clubs | Groups, member counts, event series, RSVPs, organizers, topics |
| [Partiful Events Scraper](https://apify.com/hypebridge/partiful-events-scraper) | Social parties, creator gatherings, birthday events & private RSVPs | Guest RSVP status, hosts, event themes, questionnaires, venue details |
| [Dice.fm Event Scraper](https://apify.com/hypebridge/dice-fm) | Live music, club nights, concerts & major music festivals | Lineups, ticket tiers, release phases, door policies, promoters |
| [Resident Advisor Scraper](https://apify.com/hypebridge/resident-advisor-scraper) | Electronic music, club culture, underground DJs & festivals | Event lineups, promoters, venue directories, RA picks, ticket tiers |
| [Shotgun.live Event Scraper](https://apify.com/hypebridge/shotgun-live) | Electronic music, nightlife, techno parties & international club tours | Genres, lineups, dated city sections, venue profiles, ticket prices |
| [Posh.vip Event Scraper](https://apify.com/hypebridge/posh-vip) | Nightlife, exclusive social parties, college & influencer events | Lineups, ticket groups, attendance counts, organizer contact info |
| [Xceed Events Scraper](https://apify.com/hypebridge/xceed-events-scraper) | European nightlife, clubs, festivals & electronic music | Ticket tiers, fees, age policies, lineups, venue profiles |
| [Fever Events Scraper](https://apify.com/hypebridge/fever-events-scraper) | Immersive experiences, Candlelight concerts, city tours & exhibits | Sessions, time slots, pricing tiers, user reviews, venue coordinates |
| [Showpass Event Scraper](https://apify.com/hypebridge/showpass-event-scraper) | North American events, regional festivals, comedy & venue ticketing | Ticket types, price breakdowns, venue info, organizer details |
| [Sympla Events Scraper](https://apify.com/hypebridge/sympla-events-scraper) | Brazilian & Latin American concerts, conferences & Bileto events | Ticket tiers, installment plans, Bileto sectors, organizer info |
| [Eventnoire Events Scraper](https://apify.com/hypebridge/eventnoire) | Black culture events, lifestyle, nightlife, comedy & festivals | Event details, ticketing options, organizer bios, venue profiles |
| [Prekindle Event Scraper](https://apify.com/hypebridge/prekindle) | Live music venues, indie concerts, comedy shows & regional arts | Deeplinks, venue profiles, organizer links, event descriptions |
| [Eventeny Vendor & Market Scraper](https://apify.com/hypebridge/eventeny-vendor-market-directory) | Festivals, craft fairs, conventions, artisan markets & vendor expos | Vendor applications, booth pricing, deadlines, sponsor rosters |
| [RunSignup Race Scraper](https://apify.com/hypebridge/runsignup-race-scraper) | Marathons, 5Ks, triathlons, trail runs & charity endurance races | Registration fee ladders, price change dates, sub-events, sponsors |
| [FilmFreeway Festival Scraper](https://apify.com/hypebridge/filmfreeway-festival-scraper) | Film festivals, screenplay contests & creative competitions | Submission deadlines, category entry fees, award badges, venues |

### FAQ

#### Is scraping Xceed legal?

Xceed Events Scraper only extracts publicly available data. Always check Xceed's Terms of Service and make sure you have a legitimate purpose.

#### Why is `lowestPrice` empty for an event?

It is empty in basic mode, when an event lists no tickets, or when only passes and guest lists are offered. Guest lists are free by nature and are not used for the headline price.

#### Why does an event have `enrichmentError`?

Xceed did not return the full event page after several attempts, so the record has listing and event data but no ticket offers. You are billed the basic rate for it.

### Support

- Bugs and feature requests: **Issues** tab
- Programmatic access: **API** tab

> **Disclaimer**: Our Actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our Actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

# Actor input Schema

## `startUrls` (type: `array`):

Xceed city events page (xceed.me/en/barcelona/events), event, venue or artist URL, or the xceed.me homepage to list events across Spain, Italy, France, Portugal and Germany.

## `maxEvents` (type: `integer`):

Maximum number of events returned across all start URLs. Venue and artist URLs are not counted.

## `getEventDetails` (type: `boolean`):

Visit each event page for the full description, line-up, ticket tiers, prices, fees and availability. Off returns basic listing fields only. Event URLs you paste directly always return full details.

## `country` (type: `string`):

Which country to list when a start URL is the xceed.me homepage. Ignored for city, event, venue and artist URLs.

## `maxConcurrency` (type: `integer`):

Number of requests to run in parallel. Keep this low to stay polite to Xceed.

## `debugMode` (type: `boolean`):

Verbose logging, and save the HTML of up to 5 pages that could not be read completely to the key-value store.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://xceed.me/en/barcelona/events"
    }
  ],
  "maxEvents": 100,
  "getEventDetails": true,
  "country": "any",
  "maxConcurrency": 5,
  "debugMode": false
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset containing every scraped Xceed event, venue and artist record

## `files` (type: `string`):

HTML of pages that could not be read completely (Debug mode only)

# 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 = {
    "startUrls": [
        {
            "url": "https://xceed.me/en/barcelona/events"
        }
    ],
    "maxEvents": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("hypebridge/xceed-events-scraper").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 = {
    "startUrls": [{ "url": "https://xceed.me/en/barcelona/events" }],
    "maxEvents": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("hypebridge/xceed-events-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://xceed.me/en/barcelona/events"
    }
  ],
  "maxEvents": 100
}' |
apify call hypebridge/xceed-events-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hypebridge/xceed-events-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CmrJzJZBXNVU5s3Q8/builds/zsGbFOM1bbYtU8zTb/openapi.json