# Polymarket Scraper | Events Markets Odds Volume (`lentic_clockss/polymarket-scraper`) Actor

Scrape Polymarket prediction markets — events, markets, odds, prices, volume, liquidity, tags, sports, series & teams. Filter by category or series. Export Excel/CSV/JSON. Unofficial — not affiliated with Polymarket.

- **URL**: https://apify.com/lentic\_clockss/polymarket-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** News, Automation, AI
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 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

## Polymarket Scraper — Events, Markets, Odds, Volume & Liquidity

**Scrape Polymarket prediction market data — then download structured results as Excel, CSV, or JSON.**

Use this Actor as a practical **Polymarket API alternative** for odds monitoring, event research, category tracking, and sports/series market intelligence. Enter a mode (events, event detail, search, tags, sports, series, teams, or CLOB catalog), pick a locale, and get clean Dataset rows with titles, slugs, prices, volume, liquidity, and market URLs.

- Scrape **Polymarket events**, **markets**, **tags**, **sports**, **series**, **teams**, **search**, **comments**, and **CLOB market catalog**
- Filter by **category / tag**, **series** (e.g. NFL), **sport**, **featured / active / closed**, and **sort order** (volume, liquidity, …)
- Capture **outcome prices**, **volume / volume24hr**, **liquidity**, **negRisk**, **market counts**, and optional **price history**
- Support verified locales: **en, zh, es, de, fr, pt, ru, ko, ja**
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or the Apify API
- **Pay per event** — Actor start + each Dataset result; **platform usage is included** (you do not pay separate Apify compute on top)

> Unofficial community Actor — **not affiliated with Polymarket**. Collect only publicly available metadata. You are responsible for complying with Polymarket terms and applicable law.

***

### What does the Polymarket Scraper do?

Polymarket Scraper lets you **extract structured prediction-market data from Polymarket** without running your own browser farm. Give it a mode and filters, then start a run.

Under the hood, the Actor:

1. Validates your input (mode, locale, tags / series / event slugs, filters)
2. Calls a managed Cloud Run worker that reads the public **Gamma API** (and optional **CLOB** catalog / prices-history)
3. Normalizes events, markets, tags, sports, series, teams, and comments into Dataset rows
4. Writes `RUN_SUMMARY` (and `ERROR_SUMMARY` on failure) to the key-value store

You run it like any other Apify Actor — schedule it, call it from the API, or plug it into automations.

***

### What Polymarket data can I extract?

| Data | Events list | Event detail | Markets / CLOB | Tags / Sports / Series / Teams |
| --- | :---: | :---: | :---: | :---: |
| Title / question / slug | ✅ | ✅ | ✅ | ✅ |
| Event / market URL | ✅ | ✅ | ✅ | — |
| Outcome prices / top outcomes | ✅\* | ✅ | ✅ | — |
| Volume / volume24hr / liquidity | ✅ | ✅ | ✅ | — |
| Tags / category | ✅ | ✅ | — | ✅ |
| Neg-risk / market count | ✅ | ✅ | — | — |
| Series / sport / league | ✅\*\* | ✅ | — | ✅ |
| Comments | — | ✅\*\*\* | — | — |
| CLOB tick / min size / conditionId | — | — | ✅\*\*\*\* | — |
| Price history | ✅\*\*\*\*\* | ✅\*\*\*\*\* | ✅\*\*\*\*\* | — |

\*When markets are included or flattened.\
\*\*Via `seriesSlug` / `sport` filters or expand modes.\
\*\*\*`mode=comments`.\
\*\*\*\*`mode=clob_markets`.\
\*\*\*\*\*Optional `enrichPriceHistory` (slower).

***

### Why scrape Polymarket?

Polymarket is one of the largest public prediction-market platforms. Teams scrape Polymarket to:

- Monitor **event odds and volume** across politics, crypto, sports, and culture
- Build research datasets from **category / series / sport taxonomies**
- Track **liquidity and featured markets** for quant or content workflows
- Pull **market metadata and optional price history** into dashboards or agents
- Export clean rows instead of hand-copying the Polymarket UI

Compared with leaderboard-only or whale-trade Actors, this Actor focuses on **events + markets + taxonomy** (tags, sports, series, teams) with locale-aware titles.

***

### More Actors like this

Need another site or vertical? Use a **dedicated Actor** below for structured fields. Stay on **Polymarket Scraper** for Polymarket events, markets, odds, tags, sports, series, and teams.

#### Similar intelligence & content scrapers

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)
- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)

**E-commerce**

- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)

**Real Estate**

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)

**Travel & Stays**

- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

**Social & Content**

- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)

**Ads Intelligence**

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

**Local & Maps**

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to use (no code required)

1. Click **Try for free** (or Start) on this Actor page
2. Choose a **mode** — e.g. `events`, `event`, `search`, `teams`, `clob_markets`
3. Set filters — `tagSlug` / `seriesSlug` / `sport` / `locale` / `maxItems`
4. Click **Start** — rows appear in the **Dataset** tab
5. Download **CSV / Excel / JSON**, or pull via API

#### Example inputs

**Top crypto events (Chinese locale titles where available):**

```json
{
  "mode": "events",
  "locale": "zh",
  "tagSlug": "crypto",
  "maxItems": 20,
  "includeMarkets": false
}
```

**NFL series event list (Spanish locale):**

```json
{
  "mode": "events",
  "locale": "es",
  "seriesSlug": "nfl",
  "maxItems": 20,
  "includeMarkets": false
}
```

**Single event with nested markets:**

```json
{
  "mode": "event",
  "eventSlug": "fed-decision-in-july-181",
  "locale": "en",
  "includeMarkets": true
}
```

***

### Input overview

| Field | Purpose |
| --- | --- |
| `mode` | `events`, `event`, `markets`, `search`, `tags`, `series`, `sports`, `teams`, `comments`, `categories`, `clob_markets` |
| `locale` | `en` / `zh` / `es` / `de` / `fr` / `pt` / `ru` / `ko` / `ja` |
| `tagSlug` / `tagSlugs` | Category filters for event lists |
| `seriesSlug` | Series-scoped event list (e.g. `nfl`) |
| `sport` / `league` | Sports expand / teams filter |
| `eventSlug(s)` / `eventId(s)` | Detail lookup (batch supported) |
| `query` | Public search |
| `order` | `volume24hr`, `volume`, `liquidity`, `competitive`, `startDate`, `endDate` |
| `paginationMode` | `keyset` or `offset` |
| `includeMarkets` / `flattenMarkets` | Nest or flatten market rows |
| `expandEvents` | Expand sports/series into events |
| `enrichPriceHistory` | Optional CLOB prices-history |
| `maxItems` | Result cap (free plan capped at 200/run) |

Full field docs live in the **Input** tab.

***

### Output

Each Dataset item includes a `recordType` such as `event`, `market`, `tag`, `series`, `sport`, `team`, `comment`, or `clob_market`, plus identifiers (`slug`, `id`), titles, metrics, and URLs when available.

Key-value artifacts:

- `INPUT_ECHO` — normalized non-secret input
- `RUN_SUMMARY` — status, worker source, counts, warnings
- `ERROR_SUMMARY` — present on hard failures

***

### Pricing

**Pay per event** (platform usage included — User pays platform usage = **No**):

| Event | Price |
| --- | ---: |
| Actor Start (`apify-actor-start`) | **$0.005** per start (per GB of memory, min 1) |
| result (`apify-default-dataset-item`) | **$3.00 / 1,000** on FREE & BRONZE |

**Result tier discounts** (Apify paid plan tier):

| Tier | $/1,000 | per result |
| --- | ---: | ---: |
| FREE\* | $3.00 | $0.003 |
| BRONZE | $3.00 | $0.003 |
| SILVER | $2.60 | $0.0026 |
| GOLD | $2.20 | $0.0022 |
| PLATINUM | $2.00 | $0.002 |
| DIAMOND | $1.60 | $0.0016 |

\*Apify Free plan users also have Actor-developer caps below.

#### Free Apify plan limits (Actor developer policy)

| Cap | Value |
| --- | --- |
| Free runs of this Actor | **10** total |
| Free results per run | **200** |
| Paying Apify users | Unlimited runs (schema max still applies) |

These limits are set by the Actor developer, not Apify Console. When the run quota is hit, the Actor finishes with `RUN_SUMMARY.status=FREE_TIER_LIMIT` and a clear status message (not an opaque platform error).

***

### Tips for better results

- Prefer **`tagSlug` / `seriesSlug` / `sport`** over huge unfiltered crawls
- Use **`includeMarkets: false`** on large lists; enrich with `mode=event` when needed
- For series lists, use **`seriesSlug`** (offset pagination); avoid assuming `closed=false` always applies
- Turn on **`enrichPriceHistory`** only when you need time series — it is slower
- Randomize acceptance inputs; do not reuse README examples as your only production query

***

### FAQ

**Is this an official Polymarket API?**\
No. It reads publicly available Gamma / CLOB metadata through a managed worker. Not affiliated with Polymarket.

**Do I need proxies?**\
Egress is handled on the worker side (`WORKER_PROVIDES_PROXY`). You do not mint Apify residential proxies from this thin Actor by default.

**Can I get order-book depth?**\
CLOB `/book` is out of scope (often blocked without a browser session). Use `clob_markets` and optional `enrichPriceHistory` instead.

**Which locales work?**\
Verified: en, zh, es, de, fr, pt, ru, ko, ja. Locale changes titles/URLs — it is not a multi-country TLD switch.

***

### Integrations

- Apify API / client (JS, Python)
- Schedules & webhooks
- Make, Zapier, n8n
- Export Dataset to Google Sheets, S3, or warehouses

***

### Related Actors

All **77** public Actors from \[[lentic\_clockss](https://apify.com/lentic_clockss)]. Click a name to open the Store detail page.

#### Jobs & Freelance

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)

#### E-commerce

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General Tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

# Actor input Schema

## `mode` (type: `string`):

events, event, markets, search, tags, series, sports, teams, comments, categories, or clob\_markets.

## `locale` (type: `string`):

Gamma locale for titles/URLs. Verified: en, zh, es, de, fr, pt, ru, ko, ja. Not a multi-country TLD switch.

## `tagSlug` (type: `string`):

Category tag for events (politics, crypto, sports, geopolitics, …).

## `tagSlugs` (type: `array`):

Collect events for each tag sequentially.

## `seriesSlug` (type: `string`):

Series filter for event lists (uses offset pagination), e.g. nfl.

## `sport` (type: `string`):

Sports taxonomy code; for events also used as tagSlug when tagSlug empty.

## `league` (type: `string`):

Filter for teams mode (nba, nfl, …).

## `eventSlug` (type: `string`):

Single event slug for event mode.

## `eventSlugs` (type: `array`):

Batch of event slugs for event mode.

## `eventId` (type: `string`):

Single Gamma event id.

## `eventIds` (type: `array`):

Batch of Gamma event ids.

## `query` (type: `string`):

Required for search mode.

## `order` (type: `string`):

order input field.

## `ascending` (type: `boolean`):

Sort ascending when true.

## `closed` (type: `boolean`):

Closed markets filter for Gamma keyset lists.

## `active` (type: `boolean`):

When set, filter active/inactive events.

## `featured` (type: `boolean`):

When set, filter featured events.

## `paginationMode` (type: `string`):

keyset (next\_cursor) or offset (/events/pagination with totals).

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

1–5000. Free plan capped at 200/run.

## `includeMarkets` (type: `boolean`):

includeMarkets input field.

## `flattenMarkets` (type: `boolean`):

Emit one dataset row per market instead of nested markets\[].

## `expandEvents` (type: `boolean`):

expandEvents input field.

## `enrichPriceHistory` (type: `boolean`):

Attach prices-history for up to 10 rows (slower).

## `priceHistoryDays` (type: `integer`):

priceHistoryDays input field.

## `getPositions` (type: `boolean`):

getPositions input field.

## `holdersOnly` (type: `boolean`):

holdersOnly input field.

## `featuredTagsOnly` (type: `boolean`):

featuredTagsOnly input field.

## `parentEntityType` (type: `string`):

Comments parent type: Event, Series, or PerpsAsset.

## `parentEntityId` (type: `string`):

Parent entity id for comments mode.

## `workerBaseUrl` (type: `string`):

Optional allowlisted HTTPS Cloud Run origin.

## Actor input object example

```json
{
  "mode": "events",
  "locale": "en",
  "tagSlugs": [],
  "eventSlugs": [],
  "eventIds": [],
  "order": "volume24hr",
  "ascending": false,
  "closed": false,
  "paginationMode": "keyset",
  "maxItems": 20,
  "includeMarkets": true,
  "flattenMarkets": false,
  "expandEvents": false,
  "enrichPriceHistory": false,
  "priceHistoryDays": 7,
  "getPositions": false,
  "holdersOnly": false,
  "featuredTagsOnly": false,
  "parentEntityType": "Event"
}
```

# Actor output Schema

## `results` (type: `string`):

Public Gamma-backed prediction market records.

## `runSummary` (type: `string`):

Worker, free-tier, and collection metrics.

## `inputEcho` (type: `string`):

Normalized non-secret input.

## `errorSummary` (type: `string`):

Present when a run cannot collect valid public records.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/polymarket-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/polymarket-scraper").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 '{}' |
apify call lentic_clockss/polymarket-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/ZLy836bJUfB7rh45w/builds/3aHos4frVOYfDzIe2/openapi.json