Polymarket Scraper
Try for free
3 days trial then $25.00/month - No credit card required now
Go to Store
Polymarket Scraper
saswave/polymarket-scraper
Try for free
3 days trial then $25.00/month - No credit card required now
Extract data from website polymarket.com Collect informations of search markets, profiles, leaderboard, global activity transactions, portfolio positions, profile activity, historical prices
Developer
SASWAVEMaintained by Community
Actor Metrics
2 monthly users
No reviews yet
No bookmarks yet
>99% runs succeeded
Created in Mar 2025
Modified 8 days ago
Categories
You can access the Polymarket Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
1{
2 "openapi": "3.0.1",
3 "info": {
4 "version": "0.0",
5 "x-build-id": "yE2aI5c0wZeDvvQlo"
6 },
7 "servers": [
8 {
9 "url": "https://api.apify.com/v2"
10 }
11 ],
12 "paths": {
13 "/acts/saswave~polymarket-scraper/run-sync-get-dataset-items": {
14 "post": {
15 "operationId": "run-sync-get-dataset-items-saswave-polymarket-scraper",
16 "x-openai-isConsequential": false,
17 "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
18 "tags": [
19 "Run Actor"
20 ],
21 "requestBody": {
22 "required": true,
23 "content": {
24 "application/json": {
25 "schema": {
26 "$ref": "#/components/schemas/inputSchema"
27 }
28 }
29 }
30 },
31 "parameters": [
32 {
33 "name": "token",
34 "in": "query",
35 "required": true,
36 "schema": {
37 "type": "string"
38 },
39 "description": "Enter your Apify token here"
40 }
41 ],
42 "responses": {
43 "200": {
44 "description": "OK"
45 }
46 }
47 }
48 },
49 "/acts/saswave~polymarket-scraper/runs": {
50 "post": {
51 "operationId": "runs-sync-saswave-polymarket-scraper",
52 "x-openai-isConsequential": false,
53 "summary": "Executes an Actor and returns information about the initiated run in response.",
54 "tags": [
55 "Run Actor"
56 ],
57 "requestBody": {
58 "required": true,
59 "content": {
60 "application/json": {
61 "schema": {
62 "$ref": "#/components/schemas/inputSchema"
63 }
64 }
65 }
66 },
67 "parameters": [
68 {
69 "name": "token",
70 "in": "query",
71 "required": true,
72 "schema": {
73 "type": "string"
74 },
75 "description": "Enter your Apify token here"
76 }
77 ],
78 "responses": {
79 "200": {
80 "description": "OK",
81 "content": {
82 "application/json": {
83 "schema": {
84 "$ref": "#/components/schemas/runsResponseSchema"
85 }
86 }
87 }
88 }
89 }
90 }
91 },
92 "/acts/saswave~polymarket-scraper/run-sync": {
93 "post": {
94 "operationId": "run-sync-saswave-polymarket-scraper",
95 "x-openai-isConsequential": false,
96 "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
97 "tags": [
98 "Run Actor"
99 ],
100 "requestBody": {
101 "required": true,
102 "content": {
103 "application/json": {
104 "schema": {
105 "$ref": "#/components/schemas/inputSchema"
106 }
107 }
108 }
109 },
110 "parameters": [
111 {
112 "name": "token",
113 "in": "query",
114 "required": true,
115 "schema": {
116 "type": "string"
117 },
118 "description": "Enter your Apify token here"
119 }
120 ],
121 "responses": {
122 "200": {
123 "description": "OK"
124 }
125 }
126 }
127 }
128 },
129 "components": {
130 "schemas": {
131 "inputSchema": {
132 "type": "object",
133 "properties": {
134 "max_results": {
135 "title": "Maximum results",
136 "minimum": 0,
137 "type": "integer",
138 "description": "Maximum number of data rows extracted (0 = no limit)",
139 "default": 0
140 },
141 "activity_filteramount": {
142 "title": "Profile Activity filter amount",
143 "enum": [
144 "1",
145 "10",
146 "100",
147 "1000",
148 "10000",
149 "100000"
150 ],
151 "type": "string",
152 "description": "Select profile section you want data from",
153 "default": "1"
154 },
155 "proxyConfiguration": {
156 "title": "Proxy configuration",
157 "type": "object",
158 "description": "Datacenter recommended, not mandatory"
159 },
160 "select_feature": {
161 "title": "Select Feature",
162 "enum": [
163 "markets",
164 "profile",
165 "activity",
166 "leaderboard",
167 "event"
168 ],
169 "type": "string",
170 "description": "Select profile section you want data from",
171 "default": "leaderboard"
172 },
173 "url_markets": {
174 "title": "Markets url",
175 "type": "string",
176 "description": "Search market url, should contains /markets/ For example: https://polymarket.com/markets/politics "
177 },
178 "profile_id": {
179 "title": "Profile ID",
180 "type": "string",
181 "description": "example: ID of https://polymarket.com/profile/0x9f47f1fcb1701bf9eaf31236ad39875e5d60af93 is 0x9f47f1fcb1701bf9eaf31236ad39875e5d60af93"
182 },
183 "profile_category": {
184 "title": "Profile Section Category",
185 "enum": [
186 "positions",
187 "activity"
188 ],
189 "type": "string",
190 "description": "Select profile section you want data from",
191 "default": "positions"
192 },
193 "activity_page": {
194 "title": "Get Data from Activity page",
195 "type": "boolean",
196 "description": "Helps monitoring realtime trade activity on the platform",
197 "default": true
198 },
199 "activity_only_recent": {
200 "title": "Only get recents trades data commings in",
201 "type": "boolean",
202 "description": "Helps monitoring realtime trade activity on the platform, without going down the history path of old trades (Set to true if you want real time trades, False if you want to get all trades from now to yesterday for example)",
203 "default": false
204 },
205 "activity_refresh_rate": {
206 "title": "Refresh rate",
207 "minimum": 3,
208 "type": "integer",
209 "description": "Used with activity_only_recent set to True, it helps control refreshing rate of the page",
210 "default": 5
211 },
212 "leaderboard_page": {
213 "title": "Get Data from Leaderboard page",
214 "type": "boolean",
215 "description": "Helps monitoring realtime leaders on the platform",
216 "default": true
217 },
218 "leaderboard_rangedate": {
219 "title": "Leaderboard range date filter",
220 "enum": [
221 "1d",
222 "7d",
223 "30d",
224 "all"
225 ],
226 "type": "string",
227 "description": "Select date filter",
228 "default": "30d"
229 },
230 "leaderboard_section": {
231 "title": "Leaderboard data section",
232 "enum": [
233 "volume&profit",
234 "volume",
235 "profit"
236 ],
237 "type": "string",
238 "description": "Select date section to extract data from",
239 "default": "volume&profit"
240 },
241 "event_page": {
242 "title": "Event url",
243 "type": "string",
244 "description": "Provide a specific event url to extract information from"
245 },
246 "event_feature_type": {
247 "title": "Event Feature",
248 "enum": [
249 "price",
250 "comments",
251 "top_holders",
252 "activity"
253 ],
254 "type": "string",
255 "description": "Select sort type",
256 "default": "price"
257 },
258 "holders_only": {
259 "title": "Holder only",
260 "type": "boolean",
261 "description": "Extract comments only from holders of the asset",
262 "default": false
263 },
264 "sorted_by": {
265 "title": "Sort Comments By",
266 "enum": [
267 "createdAt",
268 "reactionCount"
269 ],
270 "type": "string",
271 "description": "Select sort type",
272 "default": "createdAt"
273 }
274 }
275 },
276 "runsResponseSchema": {
277 "type": "object",
278 "properties": {
279 "data": {
280 "type": "object",
281 "properties": {
282 "id": {
283 "type": "string"
284 },
285 "actId": {
286 "type": "string"
287 },
288 "userId": {
289 "type": "string"
290 },
291 "startedAt": {
292 "type": "string",
293 "format": "date-time",
294 "example": "2025-01-08T00:00:00.000Z"
295 },
296 "finishedAt": {
297 "type": "string",
298 "format": "date-time",
299 "example": "2025-01-08T00:00:00.000Z"
300 },
301 "status": {
302 "type": "string",
303 "example": "READY"
304 },
305 "meta": {
306 "type": "object",
307 "properties": {
308 "origin": {
309 "type": "string",
310 "example": "API"
311 },
312 "userAgent": {
313 "type": "string"
314 }
315 }
316 },
317 "stats": {
318 "type": "object",
319 "properties": {
320 "inputBodyLen": {
321 "type": "integer",
322 "example": 2000
323 },
324 "rebootCount": {
325 "type": "integer",
326 "example": 0
327 },
328 "restartCount": {
329 "type": "integer",
330 "example": 0
331 },
332 "resurrectCount": {
333 "type": "integer",
334 "example": 0
335 },
336 "computeUnits": {
337 "type": "integer",
338 "example": 0
339 }
340 }
341 },
342 "options": {
343 "type": "object",
344 "properties": {
345 "build": {
346 "type": "string",
347 "example": "latest"
348 },
349 "timeoutSecs": {
350 "type": "integer",
351 "example": 300
352 },
353 "memoryMbytes": {
354 "type": "integer",
355 "example": 1024
356 },
357 "diskMbytes": {
358 "type": "integer",
359 "example": 2048
360 }
361 }
362 },
363 "buildId": {
364 "type": "string"
365 },
366 "defaultKeyValueStoreId": {
367 "type": "string"
368 },
369 "defaultDatasetId": {
370 "type": "string"
371 },
372 "defaultRequestQueueId": {
373 "type": "string"
374 },
375 "buildNumber": {
376 "type": "string",
377 "example": "1.0.0"
378 },
379 "containerUrl": {
380 "type": "string"
381 },
382 "usage": {
383 "type": "object",
384 "properties": {
385 "ACTOR_COMPUTE_UNITS": {
386 "type": "integer",
387 "example": 0
388 },
389 "DATASET_READS": {
390 "type": "integer",
391 "example": 0
392 },
393 "DATASET_WRITES": {
394 "type": "integer",
395 "example": 0
396 },
397 "KEY_VALUE_STORE_READS": {
398 "type": "integer",
399 "example": 0
400 },
401 "KEY_VALUE_STORE_WRITES": {
402 "type": "integer",
403 "example": 1
404 },
405 "KEY_VALUE_STORE_LISTS": {
406 "type": "integer",
407 "example": 0
408 },
409 "REQUEST_QUEUE_READS": {
410 "type": "integer",
411 "example": 0
412 },
413 "REQUEST_QUEUE_WRITES": {
414 "type": "integer",
415 "example": 0
416 },
417 "DATA_TRANSFER_INTERNAL_GBYTES": {
418 "type": "integer",
419 "example": 0
420 },
421 "DATA_TRANSFER_EXTERNAL_GBYTES": {
422 "type": "integer",
423 "example": 0
424 },
425 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
426 "type": "integer",
427 "example": 0
428 },
429 "PROXY_SERPS": {
430 "type": "integer",
431 "example": 0
432 }
433 }
434 },
435 "usageTotalUsd": {
436 "type": "number",
437 "example": 0.00005
438 },
439 "usageUsd": {
440 "type": "object",
441 "properties": {
442 "ACTOR_COMPUTE_UNITS": {
443 "type": "integer",
444 "example": 0
445 },
446 "DATASET_READS": {
447 "type": "integer",
448 "example": 0
449 },
450 "DATASET_WRITES": {
451 "type": "integer",
452 "example": 0
453 },
454 "KEY_VALUE_STORE_READS": {
455 "type": "integer",
456 "example": 0
457 },
458 "KEY_VALUE_STORE_WRITES": {
459 "type": "number",
460 "example": 0.00005
461 },
462 "KEY_VALUE_STORE_LISTS": {
463 "type": "integer",
464 "example": 0
465 },
466 "REQUEST_QUEUE_READS": {
467 "type": "integer",
468 "example": 0
469 },
470 "REQUEST_QUEUE_WRITES": {
471 "type": "integer",
472 "example": 0
473 },
474 "DATA_TRANSFER_INTERNAL_GBYTES": {
475 "type": "integer",
476 "example": 0
477 },
478 "DATA_TRANSFER_EXTERNAL_GBYTES": {
479 "type": "integer",
480 "example": 0
481 },
482 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
483 "type": "integer",
484 "example": 0
485 },
486 "PROXY_SERPS": {
487 "type": "integer",
488 "example": 0
489 }
490 }
491 }
492 }
493 }
494 }
495 }
496 }
497 }
498}Polymarket Scraper OpenAPI definition
OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Polymarket Scraper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients:
