{ "openapi": "3.0.1", "info": { "title": "Polymarket Market | Scraper/Screener | Smartest API V3", "description": "Easy-to-use API for Agentic AI workflows, No. 1 tool to extract market data from prediction market Polymarket. Find arbitrage opportunities, crawl all polymarkets, extract live information about markets, events, sports etc. The best and most structured output in JSON format.", "version": "0.0", "x-build-id": "XcAEtA4M4fHBu7YiO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yellowchimp~polymarket/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yellowchimp-polymarket", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/yellowchimp~polymarket/runs": { "post": { "operationId": "runs-sync-yellowchimp-polymarket", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/yellowchimp~polymarket/run-sync": { "post": { "operationId": "run-sync-yellowchimp-polymarket", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "batchSize", "fetchClosedMarkets", "sortAscending" ], "properties": { "marketId": { "title": "Market ID (Specific Market Lookup)", "type": "string", "description": "The unique ID (UUID) of a specific market to fetch (e.g., '140e70a0-0010-47b2-bd77-2e11d6b039f6'). If this is provided, all other fetch/search options are ignored.", "default": "" }, "marketSlug": { "title": "Market Slug (Specific Market Lookup)", "type": "string", "description": "The human-readable slug of a specific market to fetch (e.g., 'will-bitcoin-price-be-over-50k-on-date'). If this is provided, all other fetch/search options are ignored.", "default": "" }, "searchQuery": { "title": "Search Query (Optional)", "type": "string", "description": "A keyword or phrase to search for. If provided, the dedicated /public-search endpoint is used, where Batch Size is mapped to 'limit_per_type' and Fetch Closed Markets is mapped to 'keep_closed_markets'.", "default": "" }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of items to scrape globally. Set to 0 for unlimited.", "default": 0 }, "batchSize": { "title": "Batch Size", "type": "integer", "description": "The number of items to fetch per API request. This is used as the 'limit' for /events and 'limit_per_type' for /public-search. Default is 50.", "default": 50 }, "fetchClosedMarkets": { "title": "Fetch Closed Markets", "type": "boolean", "description": "Set to true to fetch all markets, including closed/resolved ones. Mapped to 'closed' for /events and 'keep_closed_markets=1' for /public-search. Default is false.", "default": false }, "sortAscending": { "title": "Sort Ascending", "type": "boolean", "description": "If true, results are sorted ascending. Mapped to 'ascending' for both /events and /public-search.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }