Polymarket Scraper

Extract comprehensive predictions, market trends, and betting volume data from Polymarket with ease. Scrape individual markets, category pages, search results, or the entire active predictions catalog.

---

Features

• Dynamic URL Extraction — Automatically detects and processes category pages, event pages, individual markets, or general catalog listings.
• Keyword Search Support — Search for markets and events dynamically using keywords or search terms.
• Detailed Data Fields — Extracts prediction questions, descriptions, outcomes, current prices, total volume, liquidity, resolution dates, and more.
• Data Sanitization — Automatically removes empty or null values from the dataset to deliver clean, import-ready results.
• Pagination Control — Efficiently paginates through hundreds of prediction markets using configurable limits.

---

Use Cases

Sentiment Analysis

Track public sentiment on major geopolitical events, elections, and cultural milestones in real-time. Use prediction market prices as a leading indicator of public opinion.

Crypto & Asset Research

Monitor crypto price levels, protocols, and regulatory predictions. Combine market sentiment data with token price action to build comprehensive trading strategies.

Market Intelligence

Track trading volumes, total liquidity, and outcome histories for various categories to analyze betting behavior, liquidity pools, and market efficiency.

---

Input Parameters

Parameter	Type	Required	Default	Description
url	String	No	https://polymarket.com/predictions/all	Polymarket URL to scrape (e.g. predictions page, event page, or market page).
keyword	String	No	"bitcoin"	Search keyword to look up matching events/markets. Ignored if a URL is provided.
location	String	No	—	Optional location filter to maintain schema compatibility.
results_wanted	Integer	No	20	Maximum number of market results to collect.
max_pages	Integer	No	10	Safety cap on the number of pages/offsets to fetch.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Optional proxy settings to bypass IP limits.

---

Output Data

Each market in the dataset contains the following fields (all null/undefined values are filtered out):

Field	Type	Description
id	String	Unique identifier of the market.
question	String	The prediction question or title.
slug	String	URL-friendly slug of the market.
description	String	Specific rules and conditions for resolving the market.
outcomes	Array	List of possible outcomes (e.g., ["Yes", "No"]).
outcomePrices	Array	Current trading prices for each outcome.
volume	Number	Total volume traded on the market.
liquidity	Number	Total liquidity available in the market.
startDate	String	ISO timestamp representing when the market opened.
endDate	String	ISO timestamp representing when the market resolves.
active	Boolean	Whether the market is currently active.
closed	Boolean	Whether the market has closed.
resolvedBy	String	On-chain resolution contract or address.
clobTokenIds	Array	Unique asset IDs for the outcomes.
volume24hr	Number	Trading volume in the last 24 hours.
lastTradePrice	Number	The price of the most recent trade.
bestBid	Number	Current best bid price.
bestAsk	Number	Current best ask price.
image	String	Cover image URL associated with the market.
url	String	The direct URL to view the market event on Polymarket.

---

Usage Examples

Basic Extraction

Extract all active markets from the main predictions page:

{
    "url": "https://polymarket.com/predictions/all",
    "results_wanted": 50
}

Keyword Search

Search for predictions related to "Bitcoin" or other crypto assets:

{
    "keyword": "bitcoin",
    "results_wanted": 20
}

Event Specific

Extract all sub-markets associated with a specific event:

{
    "url": "https://polymarket.com/event/what-will-happen-before-gta-vi",
    "results_wanted": 10
}

---

Sample Output

{
    "id": "540817",
    "question": "New Rihanna Album before GTA VI?",
    "slug": "new-rhianna-album-before-gta-vi-926",
    "description": "This market will resolve to \"Yes\" if Rihanna officially releases a new album before Grand Theft Auto VI is officially released in the US. Otherwise, this market will resolve to \"No\".",
    "outcomes": ["Yes", "No"],
    "outcomePrices": ["0.575", "0.425"],
    "volume": 742741.7449710022,
    "liquidity": 23875.3299,
    "startDate": "2025-05-02T15:48:10.582Z",
    "endDate": "2026-07-31T12:00:00Z",
    "active": true,
    "closed": false,
    "clobTokenIds": [
        "98022490269692409998126496127597032490334070080325855126491859374983463996227",
        "53831553061883006530739877284105938919721408776239639687877978808906551086026"
    ],
    "volume24hr": 4963.8506320000015,
    "lastTradePrice": 0.59,
    "bestBid": 0.57,
    "bestAsk": 0.58,
    "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/what-will-happen-before-gta-vi-7hpNkEzQEqUE.jpg",
    "url": "https://polymarket.com/event/what-will-happen-before-gta-vi"
}

---

Tips for Best Results

URL Formats

Ensure URLs are well-formed. The following patterns are supported:

• https://polymarket.com/predictions/all (All predictions)
• https://polymarket.com/predictions/{category} (e.g. politics, crypto, sports, science, pop-culture, business)
• https://polymarket.com/event/{event-slug} (e.g. what-will-happen-before-gta-vi)

Adjust Results Count

• Set results_wanted to a smaller value (e.g., 20) for rapid validation testing.
• Increase the count for complete historical or market snapshots.

---

Integrations

Connect your Polymarket data with modern applications:

• Google Sheets — Export for spreadsheets and analytics.
• Airtable — Build dynamic, searchable prediction trackers.
• Slack — Get alerts for new predictions or significant price movements.
• Webhooks — Automate triggers on custom endpoints.

Export Formats

• JSON — Import-ready for databases and custom apps.
• CSV — Standard format for spreadsheets and Excel.

---

Frequently Asked Questions

Can I scrape closed prediction markets?

This scraper focuses primarily on active and open predictions to provide real-time sentiment signals. Closed markets are generally resolved.

What happens to null values?

Any data fields that are not defined by the source API are removed from the outputs to ensure the exported dataset is neat and ready for data models.

Does the scraper require a proxy?

While not strictly required, a proxy configuration (such as Apify Proxy) is recommended for high-volume runs to prevent temporary rate limiting.

---

Support

For issues or custom requests, contact support through the Apify Console.

Resources

• Apify Documentation
• API Reference

---

Legal Notice

This scraper is designed for research and public data gathering purposes. Users are responsible for complying with the target platform's terms of service and applicable data retrieval laws.