Polymarket Market | Scraper/Screener | Smartest API V3

🔮 Polymarket Market Data Scraper - Flexible API Access (✅ 12/2025)

QUICK GUIDE

This Actor is a powerful tool for fetching data from the Polymarket API. It offers three primary modes: fetching a single market by ID or Slug, searching for markets based on a query, or performing a comprehensive, paginated crawl of all markets.

All results are pushed to the Dataset as individual JSON records.

Input Examples

You must provide only one of the primary fetch parameters (marketId, marketSlug, or searchQuery).
If none are provided, the Actor defaults to a Full Market Crawl.

Mode	Input JSON Example
Market Search (e.g., for "SpaceX" including closed markets)	{ "searchQuery": "SpaceX" }
Full Market Crawl (Default)	{ "batchSize": 100, "fetchClosedMarkets": false, "sortAscending": true }
Single Market by ID	{ "marketId": "98374" }

⚙️ Input Configuration

Field Name	Type	Default	Description	Fetch Mode
marketId	String	null	Fetches a single specific market using its unique numerical ID (e.g., "98374"). Takes highest priority.	Single Market by ID
marketSlug	String	null	Fetches a single specific market using its URL slug (e.g., "spacex-ipo-closing-market-cap"). Takes second priority.	Single Market by Slug
searchQuery	String	null	A keyword or phrase (e.g., "Trump", "SpaceX") to search for markets using the /public-search endpoint. Results are correctly saved to the Dataset.	Market Search
batchSize	Number	50	The number of markets to fetch per API call when searching or performing a full crawl.	Search & Full Crawl
fetchClosedMarkets	Boolean	false	If true, the scraper will include markets that are already closed or resolved.	Search & Full Crawl
sortAscending	Boolean	false	Determines the order of results when performing a full crawl (false = descending by market ID).	Full Crawl Only

🚀 Fetch Modes & Priority

The Actor executes exactly one of the following modes, checked in this order:

1. Single Market by ID (marketId)
   Endpoint: /markets/{marketId}
   Behavior: Fetches a single JSON object for the specified market.

2. Single Market by Slug (marketSlug)
   Endpoint: /markets/slug/{marketSlug}
   Behavior: Fetches a single JSON object for the specified market.

3. Market Search (searchQuery)
   Endpoint: /public-search
   Behavior: Searches for markets matching the query. Results are extracted from the events array and individually saved to the Dataset.

4. Full Market Crawl (Default)
   Endpoint: /events
   Behavior: Paginates through all available markets when no specific fetch parameters are provided.

💾 Output and Data Structure

All fetched markets are stored in the Dataset using:

Actor.push_data(data)

The output format mirrors the Polymarket API response:

{
  "id": "98374",
  "ticker": "spacex-ipo-closing-market-cap",
  "slug": "spacex-ipo-closing-market-cap",
  "title": "SpaceX IPO Closing Market Cap",
  "description": "This market will resolve based on SpaceX's market capitalization...",
  "resolutionSource": "",
  "startDate": "2025-12-06T01:34:37.744882Z",
  "endDate": "2027-12-31T00:00:00Z",
  "liquidity": 144425.35661,
  "volume": 298198.233994,
  "markets": [
    {
      "id": "842087",
      "question": "Will SpaceX's market cap be between $500B and $600B...",
      "outcomePrices": ["0.015", "0.985"],
      "volume": "28286.541268",
      "liquidityNum": 16074.91576
    }
  ]
}

💡 Use Cases

• Quantitative Market Analysis: Collect large datasets for backtesting strategies.

• Forecasting & Trends: Track prediction markets for politics, tech, and economics.

• Archiving: Build historical datasets using Full Market Crawl with fetchClosedMarkets: true.

• Industry Monitoring: Track new markets for specific industries or technologies via searchQuery.