# Partiful Events Scraper (`scrape_scaler/partiful-explore-scraper`) Actor

Scrape public Partiful explore events in NYC, LA, and San Francisco. Extract titles, dates, venues, descriptions, images, RSVP counts, and event URLs — a Partiful API alternative for event discovery and automation.

- **URL**: https://apify.com/scrape\_scaler/partiful-explore-scraper.md
- **Developed by:** [Creative Scraps](https://apify.com/scrape_scaler) (community)
- **Categories:**
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

### What does Partiful Events Scraper do?

**Partiful Events Scraper** extracts **public, discoverable events** from [Partiful](https://partiful.com) — the social invite platform used for parties, community hangouts, pop-ups, and ticketed gatherings.

It scrapes Partiful’s public **Explore** page, parses embedded event data, and returns structured JSON with titles, dates, locations, descriptions, images, guest counts, and direct event URLs. Use it as a **Partiful API alternative** for event discovery, local calendars, marketing research, and automation pipelines.

> **Scope:** This Actor only returns events listed on Partiful Explore (public events). Private invite-only events are not accessible without an invite link.

***

### Why scrape Partiful?

Partiful has become a go-to platform for **social and community events** — especially in NYC, LA, and the Bay Area. There is no public developer API, so scraping is the practical way to:

- Build **local event feeds** and city calendars
- Monitor **trending public events** in major metros
- Enrich event databases for apps, newsletters, or recommendation engines
- Track **community gatherings, pop-ups, and social activations** alongside Ticketmaster, Eventbrite, and Luma data

#### Features

- Scrapes Partiful Explore trending events for **NYC, Los Angeles, and San Francisco**
- Filters by **city/region** and **date range**
- Returns normalized fields: title, description, start/end time, timezone, venue, address, image, RSVP counts, and event URL
- Runs on Apify with **proxy support**, scheduling, API access, and dataset export (JSON, CSV, Excel)

***

### What data can you extract?

| Field | Description |
|-------|-------------|
| `name` / `title` | Event title |
| `url` | Public Partiful event link (`partiful.com/e/...`) |
| `startAt` / `endAt` | ISO 8601 start and end datetime |
| `timezone` | IANA timezone (e.g. `America/New_York`) |
| `description` | Event description text |
| `coverImageUrl` | Event cover image URL |
| `location.venue` | Venue or place name |
| `location.address` | Formatted address lines |
| `location.city` | City / approximate location |
| `location.neighborhood` | Neighborhood when available |
| `guestCounts.going` | Number of guests marked going |
| `guestCounts.interested` | Number of interested guests |
| `region` | Partiful region code: `NYC`, `LA`, or `SF` |
| `partiful_event_id` | Unique Partiful event ID |

***

### How to scrape Partiful events

1. Open **Partiful Events Scraper** on Apify Store and click **Try for free** or **Start**.
2. Choose a **city** (`New York`, `Los Angeles`, or `San Francisco`) — or leave city empty to scrape all three explore regions.
3. Set **startDate** and **endDate** in `YYYY-MM-DD` format to filter the date window.
4. Click **Start** and wait for the run to finish.
5. Download results from the **Dataset** tab as JSON, CSV, or Excel — or call the Actor via the Apify API.

#### Quick start input

```json
{
  "city": "New York",
  "startDate": "2026-08-01",
  "endDate": "2026-12-31",
  "maxItems": 20
}
```

Leave `city` empty to return trending events from **NYC, LA, and SF** in one run.

***

### How much will it cost?

This Actor runs on **Apify platform usage** (compute + proxy traffic). Each run fetches a single Explore page and typically returns **up to ~15 public trending events** (about 5 per region).

Because Explore is a single-page scrape, runs are **fast and inexpensive** — usually a few cents per run depending on your Apify plan and proxy settings. Residential proxies are enabled by default but can be adjusted in input.

For high-volume pipelines, schedule weekly runs per city rather than continuous polling.

***

### Input

See the **Input** tab in Apify Console for the full schema. Main fields:

| Field | Required | Description |
|-------|----------|-------------|
| `city` | No | `New York`, `Los Angeles`, or `San Francisco`. Omit for all regions. |
| `region` | No | Override with `NYC`, `LA`, or `SF` |
| `startDate` | No | `YYYY-MM-DD` — default: today (UTC) |
| `endDate` | No | `YYYY-MM-DD` — default: +30 days (UTC) |
| `maxItems` | No | Stop after N events |
| `proxyConfiguration` | No | Apify proxy settings (residential by default) |

***

### Output

Results are saved to the default **Dataset**. Export as JSON, CSV, HTML, or Excel from the run page or via API.

#### Sample output

```json
{
  "source": "partiful",
  "partiful_event_id": "G5T1visd0LOmscq9n7pA",
  "name": "Guinness world record attempt: DUCK DUCK GOOSE",
  "title": "Guinness world record attempt: DUCK DUCK GOOSE",
  "url": "https://partiful.com/e/G5T1visd0LOmscq9n7pA",
  "startAt": "2026-10-24T17:00:00.000Z",
  "endAt": null,
  "timezone": "America/New_York",
  "description": "Reclaim your childhood and join the world's largest game of duck duck goose!...",
  "coverImageUrl": "https://firebasestorage.googleapis.com/v0/b/getpartiful.appspot.com/o/...",
  "location": {
    "venue": "Central Park",
    "fullAddress": "New York, NY, New York, NY 10028",
    "address": "New York, NY, New York, NY 10028",
    "city": "New York, NY",
    "neighborhood": "Central Park"
  },
  "guestCounts": {
    "interested": 389,
    "going": 242,
    "approved": 0
  },
  "region": "NYC",
  "isPublic": true,
  "status": "PUBLISHED"
}
```

***

### Limits and tips

- **Public explore only** — Most Partiful events are private (invite-link access). This Actor surfaces only what Partiful shows on `/explore`.
- **Three metros today** — Explore currently highlights NYC, LA, and SF (~5 trending events each).
- **Date filtering** happens after scrape — events outside your date window are excluded from output.
- **No coordinates** — Partiful explore data usually includes addresses but not lat/lon; geocode downstream if needed.

***

### FAQ

#### Does Partiful have an official API?

No public developer API exists for listing explore events. This Actor provides structured access to public explore data.

#### Can I scrape private Partiful events?

No. Only public events visible on Partiful Explore are returned.

#### Which cities are supported?

New York (NYC), Los Angeles (LA), and San Francisco / Bay Area (SF). Omit `city` to fetch all three.

#### Can I run this on a schedule?

Yes. Use Apify Schedules or call the Actor from n8n, Zapier, Make, or your own backend via the Apify API.

***

### Disclaimer

Our Actors are ethical and do not extract private user data such as email addresses or phone numbers. They only extract information from **publicly discoverable** Partiful explore listings. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your use case is compliant, consult your legal team.

Partiful is a trademark of its respective owner. This Actor is not affiliated with or endorsed by Partiful.

***

### Support

Found a bug or need a new field? Open an issue on the Actor’s **Issues** tab in Apify Console. For API integration, see the **API** tab on your Actor run page.

# Actor input Schema

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

Filter to one metro: New York, Los Angeles, or San Francisco. Leave empty to scrape all explore regions (NYC, LA, SF).

## `region` (type: `string`):

Optional Partiful region override instead of city name: NYC, LA, or SF.

## `startDate` (type: `string`):

Include events starting on or after this date (YYYY-MM-DD). Defaults to today (UTC).

## `endDate` (type: `string`):

Include events starting on or before this date (YYYY-MM-DD). Defaults to 30 days from today (UTC).

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

Stop after this many unique events. Explore typically returns ~5 events per region (~15 total).

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. Residential US proxy is the default.

## Actor input object example

```json
{
  "city": "New York",
  "region": "NYC",
  "startDate": "2026-08-01",
  "endDate": "2026-12-31",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `events` (type: `string`):

All scraped Partiful events

## `run` (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": "New York",
    "startDate": "2026-08-01",
    "endDate": "2026-12-31",
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrape_scaler/partiful-explore-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 = {
    "city": "New York",
    "startDate": "2026-08-01",
    "endDate": "2026-12-31",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("scrape_scaler/partiful-explore-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 '{
  "city": "New York",
  "startDate": "2026-08-01",
  "endDate": "2026-12-31",
  "maxItems": 20
}' |
apify call scrape_scaler/partiful-explore-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrape_scaler/partiful-explore-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/x0nddtOroz7Wbhfnd/builds/qc9qCRrXyykleSD6X/openapi.json