# PredictIt Markets Scraper (`parseforge/predictit-markets-scraper`) Actor
Mine all open PredictIt prediction markets with market\_id, name, short\_name, contracts, last\_trade\_price, best\_buy\_yes, and best\_sell\_yes. Filter markets by name substring. Useful for election forecasting, sentiment tracking, and building prediction market datasets.
- **URL**: https://apify.com/parseforge/predictit-markets-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation, Integrations, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $7.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## ๐ณ๏ธ PredictIt Markets Scraper
> ๐ **Export every active PredictIt prediction market in seconds, with all contracts, last trade prices, and best buy/sell quotes, straight from the public predictit.org marketdata feed.**
> ๐ **Last updated:** 2026-05-29 ยท **๐ 12 fields** per record ยท All active PredictIt markets ยท Political prediction trading
The PredictIt Markets Scraper pulls the full PredictIt market book in one call, flattening each market with its nested contracts, prices, and quotes into clean structured records.
| ๐ฏ Target Audience | ๐ก Primary Use Cases |
|---|---|
| ๐ณ๏ธ Political analysts | Track election odds |
| ๐ Forecasters | Compare vs Polymarket / Kalshi |
| ๐ข Hedge funds | Event-driven trading signals |
| ๐ค ML researchers | Build forecasting datasets |
| ๐ฐ Journalists | Real-time event probabilities |
| ๐ฉโ๐ป Developers | Mirror PredictIt locally |
### ๐ What the PredictIt Markets Scraper does
- Calls `https://www.predictit.org/api/marketdata/all/`.
- Flattens every market with its contracts and quotes.
- Optionally filters by market name substring.
- Exports as CSV, Excel, JSON, JSONL, XML, RSS, or HTML.
> ๐ก **Why it matters:** PredictIt is one of the longest-running US prediction markets. Their public feed is the source of truth for political odds reporting.
### ๐ฌ Full Demo
_๐ง Coming soon._
### โ๏ธ Input
Field
Type
Required
Description
maxItems
integer
No
Free 10, paid up to 1M.
nameContains
string
No
Substring on market name.
**Example 1:**
```json
{ "maxItems": 10 }
````
**Example 2:**
```json
{ "nameContains": "president" }
```
> โ ๏ธ **Good to Know:** The PredictIt marketdata feed is fully public. No key required.
### ๐ Output
| Field | Type | Description |
|---|---|---|
| ๐ผ๏ธ `imageUrl` | string | Market image. |
| ๐ `market_id` | number | PredictIt market ID. |
| ๐ `name` | string | Full market name. |
| ๐ `short_name` | string | Short label. |
| ๐ `url` | string | Public URL. |
| ๐ข `status` | string | Market status. |
| ๐ `contracts` | array | All contracts with prices. |
| ๐ฒ `last_trade_price` | number | First contract last trade. |
| ๐ฉ `best_buy_yes` | number | First contract best buy yes. |
| ๐ฅ `best_sell_yes` | number | First contract best sell yes. |
| ๐ `scrapedAt` | string | When fetched. |
| โ `error` | string | Error if upstream failed. |
**Sample record:**
```json
{
"imageUrl": "https://predictit.org/image.png",
"market_id": 7456,
"name": "Who will win the 2028 US presidential election?",
"short_name": "2028 POTUS",
"url": "https://www.predictit.org/markets/detail/7456",
"status": "Open",
"contracts": [{ "id": 1, "name": "Candidate X", "last_trade_price": 0.32 }],
"last_trade_price": 0.32,
"best_buy_yes": 0.33,
"best_sell_yes": 0.31,
"scrapedAt": "2026-05-29T13:00:00.000Z",
"error": null
}
```
### โจ Why choose this Actor
| ๐ | Public PredictIt feed, no key. |
| ๐ณ๏ธ | Full market book in one call. |
| ๐ข | Numeric casting on every price. |
| ๐ | Errors surfaced cleanly. |
| ๐ | Name substring filter. |
| ๐พ | CSV / Excel / JSON / XML / RSS / HTML. |
### ๐ How it compares to alternatives
| Approach | Setup | Numeric cast? | Filter? | Errors? |
|---|---|---|---|---|
| Raw fetch | 15 min | โ | โ | โ |
| Custom parser | 30+ min | partial | partial | partial |
| **This Actor** | 5 sec | โ | โ | โ |
### ๐ How to use
1. Click **Try for free**.
2. Optional `nameContains` filter.
3. Click **Start**.
### ๐ผ Business use cases
**๐ Election odds dashboards.** Build live dashboards for news desks.
**๐ผ Hedge fund signals.** Trade event-driven baskets.
**๐ฐ Newsroom.** Verify probability claims in stories.
**๐ค ML.** Build forecast training sets.
### ๐ Automating PredictIt Markets Scraper
- **Make / Zapier** to Airtable / Slack.
- **Cron schedule** native Apify.
- **Webhooks** on completion.
- **Pipe to BigQuery / Snowflake / Postgres**.
### ๐ Beyond business use cases
**๐ Education.** Teach forecasting / Bayesian inference.
**๐งช Personal research.** Track your favourite markets.
**๐ค Open data.** Public political odds dashboards.
**๐งฐ Prototyping.** Quick feed.
### ๐ค Ask an AI assistant about this scraper
Drop this README into ChatGPT or Claude.
### โ Frequently Asked Questions
**โ API key?** None.
**โ Refresh?** Per-call snapshot.
**โ Filter?** Yes, by name substring.
**โ Cast?** Yes.
**โ Errors?** Clean `{error}` record.
**โ Schedule?** Yes.
**โ API or scraping?** Public marketdata feed.
**โ Schema stable?** Yes.
**โ Formats?** CSV, Excel, JSON, JSONL, XML, RSS, HTML.
**โ Coverage?** All active PredictIt markets.
### ๐ Integrate with any app
Apify integrations with Make, Zapier, Slack, Discord, Google Drive, Google Sheets, Gmail, Airbyte, Keboola, Telegram, GitHub, REST/webhook.
### ๐ Recommended Actors
| Actor | What it does |
|---|---|
| [ParseForge Metaculus Questions Scraper](https://apify.com/parseforge/metaculus-questions-scraper) | Forecasting questions. |
| [ParseForge The Odds API Sports Scraper](https://apify.com/parseforge/the-odds-api-sports-scraper) | Sports betting markets. |
| [ParseForge Stocktwits Trending Symbols Scraper](https://apify.com/parseforge/stocktwits-trending-symbols-scraper) | Retail sentiment. |
| [ParseForge Alpha Vantage Public Scraper](https://apify.com/parseforge/alpha-vantage-public-scraper) | Stocks, FX, crypto. |
> ๐ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for 900+ scrapers.
***
**Disclaimer:** This actor scrapes only publicly available data. ParseForge is not affiliated with, endorsed by, or sponsored by any of the third-party services referenced. Users are responsible for complying with the target site's terms of service and applicable law. [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp).
# Actor input Schema
## `maxItems` (type: `integer`):
Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000
## `nameContains` (type: `string`):
Case-insensitive substring filter on market name. Empty = all.
## Actor input object example
```json
{
"maxItems": 10
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/predictit-markets-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`๐พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "maxItems": 10 }
# Run the Actor and wait for it to finish
run = client.actor("parseforge/predictit-markets-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("๐พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10
}' |
apify call parseforge/predictit-markets-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=parseforge/predictit-markets-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "PredictIt Markets Scraper",
"description": "Mine all open PredictIt prediction markets with market_id, name, short_name, contracts, last_trade_price, best_buy_yes, and best_sell_yes. Filter markets by name substring. Useful for election forecasting, sentiment tracking, and building prediction market datasets.",
"version": "0.1",
"x-build-id": "sWLmTyVKpwKq69ZI3"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parseforge~predictit-markets-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parseforge-predictit-markets-scraper",
"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/parseforge~predictit-markets-scraper/runs": {
"post": {
"operationId": "runs-sync-parseforge-predictit-markets-scraper",
"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/parseforge~predictit-markets-scraper/run-sync": {
"post": {
"operationId": "run-sync-parseforge-predictit-markets-scraper",
"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",
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
},
"nameContains": {
"title": "Filter by market name",
"type": "string",
"description": "Case-insensitive substring filter on market name. Empty = all."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```