Skip to content

Polymarket Scraper: Public Market Data in One Request

Polymarket pages are JavaScript-heavy and sit behind bot detection, so a plain HTTP fetch often returns an empty shell.

OUTPUT FORMATSHTMLJSONMarkdown

A managed scraper handles rendering, proxy rotation and CAPTCHA handling on your behalf. This page explains what you send, what comes back, how credits are charged, and when a direct Polymarket API or on-chain read is the better fit.

What this scraper does

You hand over a public Polymarket URL. The service loads the page in a real headless browser, executes the JavaScript, rotates the outbound IP, and returns the rendered response. You can then parse the HTML yourself, apply CSS or XPath extraction rules, or use AI extraction rules to get structured JSON back. The same request can also return a full-page screenshot if you need a visual record of how the page rendered.

Three common ways teams use it

Most Polymarket scraping falls into one of three jobs:

  • Trend monitoring. Pull current market titles and implied probabilities on a schedule to see how sentiment shifts across a set of markets.
  • Betting-market data collection. Collect structured market data to compare activity and dynamics across markets.
  • Order book depth tracking. Pull order book depth, volume-weighted prices and resolution outcomes per market for research on prediction-market signals.

Each pattern uses the same request shape; the difference is which fields you extract and how often you run the job.

Fields returned from a Polymarket market page

A Polymarket market page can return the following fields, depending on what the page renders publicly:

FieldWhat it represents
Market titleThe question the market resolves
Implied probabilityThe current market-implied chance of each outcome
Order book depthLiquidity available at each price level
Volume tradedTotal volume exchanged on the market
Unique trader countNumber of distinct traders active on the market
Resolution outcomesThe final or current outcome state

These are the fields the scraper is built to surface. If a field is not rendered on the public page, the scraper cannot extract it.

Request inputs and what they change

The request is a single call with the target URL and your API key. Optional parameters let you tune how the page is loaded and what comes back:

InputEffect
Target URLThe Polymarket page to load
render_jsRuns the page in a real headless browser and returns post-render HTML
stealth_proxyAdds stealth proxy handling for aggressive bot detection or CAPTCHA challenges
country_codeRoutes the request through a specific country or territory
extract_rulesCSS or XPath selectors that return structured data
ai_extract_rulesNatural-language extraction rules that return structured JSON
Screenshot optionCaptures a full-page screenshot of the rendered page

A practical starting sequence is: send the URL with render_js enabled, inspect the returned HTML, then add extract_rules or ai_extract_rules once you know which selectors or fields you need.

Worked example: one market page

Suppose you want to track a single Polymarket market page. You send the page URL with render_js enabled and an ai_extract_rules instruction asking for market title, implied probability, order book depth, volume traded, unique trader count and resolution outcome. The service renders the page, runs the extraction, and returns JSON with those fields. You store the JSON with a timestamp, then repeat the call on your chosen schedule to build a time series. If the page starts returning a CAPTCHA or an empty shell, add stealth_proxy to the request before assuming the market has changed.

How credits are charged

API credits are valid for one month and do not roll over. A standard request starts at 1 credit. Enabling JavaScript rendering costs 5 credits per successful request. Enabling premium proxies costs 10 credits with JS rendering disabled, or 25 credits with JS rendering enabled. Plan tiers differ in monthly credit allowance and concurrent request limits; the plan table below lists the exact figures.

Plan comparison

The table below reproduces the plan tiers, monthly credit allowances, concurrency limits and feature availability. Prices are exclusive of VAT. Treat the figures as a dated reference and confirm current pricing before committing.

Decision checklist: managed scraper vs. direct API

Before you build, decide which collection path fits your task:

  • Do you need rendered page content? If the fields you want only appear after JavaScript runs, a managed rendering scraper is the simpler path. If the data is available from a direct Polymarket API or on-chain read, that may be cheaper and more stable.
  • How often will you run it? High-frequency polling multiplies credit usage. Estimate monthly credits from your request count and the credit cost per request type.
  • Do you need structured output? If yes, plan to use extract_rules or ai_extract_rules rather than parsing raw HTML downstream.
  • Are you hitting bot detection? If plain requests return CAPTCHAs or empty shells, add stealth_proxy before assuming the page content has changed.
  • Do you need a visual record? If yes, enable the screenshot option alongside the data extraction.

Telling apart the three common failures

A failed Polymarket scrape usually falls into one of three categories, and each has a different fix:

  • IP-based blocking. The request is rejected before the page loads. Rotating proxies and a real browser profile reduce this risk.
  • JavaScript not executed. The response contains an empty shell because the page needs client-side rendering. Enable render_js so the page runs in a headless browser.
  • CAPTCHA or aggressive bot challenge. The page loads a challenge instead of content. Enable stealth_proxy to route through stealth handling.

Diagnosing which category you are in before changing parameters saves credits and debugging time.

Setup in a few minutes

Create an account to get an API key and free test credits. Use the dashboard request builder to paste a Polymarket URL, set parameters, and preview the response. When the request looks right, copy the generated snippet in Python, Node, Go, PHP, Ruby or cURL and drop it into your codebase. The same request shape works across languages; only the client wrapper changes.

Plan comparison (dated reference)
PlanPrice /moAPI CreditsConcurrent requestsJavaScript renderingRotating & Premium ProxiesGeotargetingScreenshots & Extraction RulesPriority Email SupportDedicated Account ManagerTeam Management
Hobby$1975,00025IncludedIncludedIncludedIncludedNot includedNot includedNot included
Freelance$49250,00050IncludedIncludedIncludedIncludedNot includedNot includedNot included
Startup (Recommended)$991,000,000100IncludedIncludedIncludedIncludedNot includedNot includedNot included
Business$2493,000,000200IncludedIncludedIncludedIncludedIncludedIncludedIncluded
Business +$5998,000,000400IncludedIncludedIncludedIncludedIncludedIncludedIncluded
Enterprise 14$99914,000,000500IncludedIncludedIncludedIncludedIncludedIncludedIncluded
Enterprise 24$1,59924,000,000600IncludedIncludedIncludedIncludedIncludedIncludedIncluded
Enterprise 41 (Recommended)$2,39941,000,000700IncludedIncludedIncludedIncludedIncludedIncludedIncluded
Enterprise 69$3,59969,000,000800IncludedIncludedIncludedIncludedIncludedIncludedIncluded
Enterprise 120$5,799120,000,000900IncludedIncludedIncludedIncludedIncludedIncludedIncluded

Prices are exclusive of VAT. Figures are a dated reference; confirm current pricing before committing.

Frequently asked questions

Is scraping Polymarket legal?

Scraping rules vary by jurisdiction and by site. Before you collect anything, read Polymarket's terms of service and any applicable local law, and limit your collection to pages that are publicly visible without logging in. Content behind a login or paywall is out of scope. This is general information, not legal advice — have counsel review your specific use case.

What data can I extract from Polymarket?

You can target any field that the public page actually renders. Two extraction paths are available: extract_rules lets you point at elements with CSS selectors, while ai_extract_rules lets you describe the fields you want in natural language. Either path returns structured JSON you can store or process downstream.

How do I start scraping Polymarket?

Sign up, grab your API key, and send a GET request with the target URL. The service renders the page, rotates proxies, and returns the data. Free test credits are available to get started.

Will I get blocked when scraping Polymarket?

Requests are routed through rotating residential proxies and a real headless browser, which makes them resemble ordinary visitor traffic rather than a script. If a particular target tightens its defenses, add stealth_proxy to that request to apply the stronger stealth handling.

Can I scrape Polymarket without writing code?

Yes. The dashboard request builder lets you paste a URL, set parameters, and copy the generated snippet in Python, Node, Go, PHP, Ruby, or cURL.

How do I handle JavaScript when scraping Polymarket?

Pass render_js=true on the request. The page runs in a real headless browser, the JavaScript executes server-side, and you get the post-render HTML back.