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: json { "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.