# CALIFORNIA  LOTTERY (`syntellect_ai/ca-lotto-draw-games`) Actor

California Lottery Hot Spot historical data scraper. Fast and reliable extraction of past winning numbers with customizable draw limits."CALOTTERY.COM PAST GAME SCRAPER

- **URL**: https://apify.com/syntellect\_ai/ca-lotto-draw-games.md
- **Developed by:** [christopher athans crow](https://apify.com/syntellect_ai) (community)
- **Categories:** Developer tools, News, AI
- **Stats:** 8 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 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.

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

🎰 CA Lottery Recon Scout (Ultimate Edition)
===========================================

The most comprehensive data engine for the California State Lottery [2026 Updated]. This Actor isn't just a scraper; it’s a profitability engine that cross-references Draw Games and "Lucky Retailer" locations to give you a statistical edge.

🚀 Why Use This Actor?
----------------------

Unlike basic scrapers, the Omniscient Scout intercepts hidden API calls used by the official CA Lottery React frontend. This means you get faster results, cleaner JSON, and access to data points that aren't easily visible on the website.

#### Key 2026 Data Points:

*   **Draw Intelligence**: Instant winning number extraction for Powerball, Mega Millions, and SuperLotto Plus, complete with official PDF reports.
*   **Lucky Retailer Geo-Pulse**: Maps stores with "Lucky" status directly from the Where to Play maps API.
*   **Lucky Number Historicals**: Direct extraction of the Lucky Numbers tool.


The CA Lottery Recon Scout operates on a Freemium model. 
🆓 FREE TIER: 
By default, the Actor gives you the last 5 draw results and limits map data to city-level only. Precise store addresses, coordinates, and Official CA Lottery PDF reports are obfuscated.

💎 PRO TIER ($2.50 / 1,000 results):
Unlocks the full capability of the Recon engine. 
- Unlimited Historical API Draw Results
- Extraction of Official winning PDF reports
- Exact latitude/longitude and street addresses for "Lucky Retailers"
- The built-in Profitability Score Analyzer



🛠️ How It Works
----------------

**Input:** Enter the target Zip Code, and toggle whether you want to extract PDFs. Add your PRO license key for unlimited access!

**Scout:** The Actor hits the CA Lottery internal endpoints (bypassing slow HTML rendering).

**Output:** You receive a structured JSON ready for analysis.

#### Example Output (Pro)

```json
{
  "meta": {
    "scout_time": "2026-03-02T06:36:44.218Z",
    "is_pro_tier": true
  },
  "drawGames": [
    {
      "gameName": "POWERBALL",
      "gameId": 12,
      "pastDraws": [
        {
          "drawNumber": 1582,
          "drawDate": "2026-02-28",
          "winningNumbers": [
            { "number": "6", "isSpecial": false },
            { "number": "20", "isSpecial": false },
            { "number": "10", "isSpecial": true }
          ],
          "jackpotAmount": null
        }
      ]
    }
  ],
  "luckyNumbersTool": {
    "game": "Any",
    "status": "The Lucky Numbers tool requires manual number input to check historical data.",
    "availableGames": ["Mega Millions", "SuperLotto Plus", "Powerball"]
  },
  "retailersMapData": {
    "zip": "90210",
    "retailers": [
      {
        "name": "LUCKY STORE #1",
        "retailer_address": "123 MAIN ST",
        "map_coordinates": "34.0901, -118.4065"
      }
    ],
    "total": 1
  }
}
````

## 🔒 Getting a Pro Key

To unlock the full database, Map coordinates, PDFs, and the Profitability Score engine:

1. Subscribe via the Apify Store Monetization tier.
2. Or if you have a direct license key, enter your key into the `licenseKey` field in the Actor input.
3. Run the Actor with unlimited results.

## ⚠️ Disclaimer

This tool is for educational and analytical purposes only. Lottery games involve risk; use this data to make informed decisions, but remember that winning is never guaranteed.

***

*Maintained by: syntellect\_ai / CA Lotto Recon*
*Last Updated: March 2026*

# Actor input Schema

## `licenseKey` (type: `string`):

Enter your Pro key to unlock full historical data, map data, PDFs, and all lucky retailers.

## `maxResults` (type: `integer`):

Free users are capped at 5 results per run. Pro users unlock unlimited data.

## `zipCode` (type: `string`):

Zip code parameter for Retailers map data. If left blank, random 50 are grabbed.

## `extractPDFs` (type: `boolean`):

Extract links to CA Lottery official PDFs (Pro feature)

## Actor input object example

```json
{
  "maxResults": 5,
  "extractPDFs": false
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("syntellect_ai/ca-lotto-draw-games").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("syntellect_ai/ca-lotto-draw-games").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 '{}' |
apify call syntellect_ai/ca-lotto-draw-games --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=syntellect_ai/ca-lotto-draw-games",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "CALIFORNIA  LOTTERY",
        "description": "California Lottery Hot Spot historical data scraper. Fast and reliable extraction of past winning numbers with customizable draw limits.\"CALOTTERY.COM PAST GAME SCRAPER",
        "version": "1.0",
        "x-build-id": "cSRw0XptYlJl5iuTO"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/syntellect_ai~ca-lotto-draw-games/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-syntellect_ai-ca-lotto-draw-games",
                "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/syntellect_ai~ca-lotto-draw-games/runs": {
            "post": {
                "operationId": "runs-sync-syntellect_ai-ca-lotto-draw-games",
                "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/syntellect_ai~ca-lotto-draw-games/run-sync": {
            "post": {
                "operationId": "run-sync-syntellect_ai-ca-lotto-draw-games",
                "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": {
                    "licenseKey": {
                        "title": "License Key",
                        "type": "string",
                        "description": "Enter your Pro key to unlock full historical data, map data, PDFs, and all lucky retailers."
                    },
                    "maxResults": {
                        "title": "Max Results (Free Tier Limit)",
                        "minimum": 1,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Free users are capped at 5 results per run. Pro users unlock unlimited data.",
                        "default": 5
                    },
                    "zipCode": {
                        "title": "Zip Code",
                        "type": "string",
                        "description": "Zip code parameter for Retailers map data. If left blank, random 50 are grabbed."
                    },
                    "extractPDFs": {
                        "title": "Extract PDFs",
                        "type": "boolean",
                        "description": "Extract links to CA Lottery official PDFs (Pro feature)",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
