LotteryPost APIlotterypost.com ↗
Fetch lottery results, historical drawings, jackpot amounts, and game listings for US states and major worldwide lotteries via the LotteryPost.com API.
What is the LotteryPost API?
The LotteryPost.com API exposes 5 endpoints covering lottery results, historical drawing data, and live jackpot standings for US states and major worldwide games. The get_state_results endpoint returns the most recent winning numbers, bonus numbers, and next-draw details for every active game in a given state, while get_jackpots ranks current jackpot amounts globally with change tracking across draws.
curl -X GET 'https://api.parse.bot/scraper/76d00006-2092-4ae3-81d2-58e8ccd84550/get_state_results?state=NY' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lotterypost-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.lottery_post_api import LotteryPost
client = LotteryPost()
# Get latest results for New York
ny = client.stateresults.get(state="NY")
print(ny.state)
for result in ny.results:
print(result.game_name, result.drawing_date, result.winning_numbers, result.bonus_numbers)
# List available games for NY
for game in ny.games():
print(game.game_name, game.game_slug, game.game_id)
# Get historical drawings for a specific game
for drawing in ny.history(game="lotto", year="2026"):
print(drawing.date, drawing.winning_numbers, drawing.bonus_numbers)
# Get worldwide jackpots ranked by size
for jackpot in client.jackpots.list():
print(jackpot.rank, jackpot.game, jackpot.amount, jackpot.next_draw_date)
# Bulk fetch results for multiple states
for state_result in client.stateresults.bulk(states="NY,CA,TX"):
print(state_result.state)
for result in state_result.results:
print(result.game_name, result.winning_numbers)
Retrieve latest lottery results and next drawing/jackpot info for a specific state. Returns all games with their most recent drawing numbers, bonus numbers, and upcoming draw information.
| Param | Type | Description |
|---|---|---|
| state | string | Two-letter US state code (e.g. NY, CA, TX, FL, PA, IL, OH, GA, MI, NJ). |
{
"type": "object",
"fields": {
"state": "string, two-letter state code",
"results": "array of game result objects with game_slug, game_name, game_id, drawing_date, drawing_timestamp, winning_numbers, bonus_numbers, and optional next_jackpot, jackpot_change, next_drawing"
},
"sample": {
"data": {
"state": "NY",
"results": [
{
"game_id": "144",
"game_name": "Numbers Midday",
"game_slug": "numbers",
"drawing_date": "Wednesday, June 10, 2026",
"next_drawing": "Thu, Jun 11, 2026, 2:30 pmEastern Time (GMT-5:00)22 hours from now",
"bonus_numbers": [],
"winning_numbers": [
"9",
"9",
"3"
],
"drawing_timestamp": "2026-06-10T14:30-05:00"
},
{
"game_id": "143",
"game_name": "Lotto",
"game_slug": "lotto",
"drawing_date": "Saturday, June 6, 2026",
"next_drawing": "Wed, Jun 10, 2026, 8:15 pmEastern Time (GMT-5:00)3 hours from now",
"next_jackpot": "$3 Million",
"bonus_numbers": [
"12"
],
"jackpot_change": "$100,000",
"winning_numbers": [
"2",
"11",
"29",
"31",
"32",
"56"
],
"drawing_timestamp": "2026-06-06T20:15-05:00"
}
]
},
"status": "success"
}
}About the LotteryPost API
Endpoints and Coverage
Five endpoints cover the main data surfaces on LotteryPost.com. get_state_results accepts a two-letter state code and returns an array of game result objects — each with game_name, game_slug, drawing_date, drawing_timestamp, winning_numbers, and bonus_numbers — along with upcoming draw and jackpot info. get_multiple_states_results accepts a comma-separated states parameter and batches the same per-state result objects into one response, which is useful when you need to compare results across several states without issuing separate calls.
Game Listings and Historical Data
get_state_games returns the full list of games available for a state, including each game's game_name, game_slug, and game_id. Those slugs feed directly into get_historical_results, which accepts game, state, year, and month parameters. Historical results return an array of drawing objects with date, timestamp, winning_numbers, and bonus_numbers. Guest access is limited to the past 12 months of history; requests for older data outside that window will not return results.
Jackpot Feed
get_jackpots requires no input parameters and returns a ranked list of current jackpots worldwide. Each entry includes rank, amount, region, game, game_link, next_draw_date, prev_jackpot, and change — making it straightforward to detect jackpot growth or rollover between consecutive draws.
Data Notes
Game slugs from get_state_games are the reliable way to construct valid get_historical_results requests; hardcoding slugs without verifying them for a given state may return empty results. The month filter on historical results requires year to also be set. Coverage spans US state lotteries and major multi-state games (Powerball, Mega Millions) as well as international lotteries surfaced through the jackpot endpoint.
The LotteryPost API is a managed, monitored endpoint for lotterypost.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lotterypost.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official lotterypost.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display tonight's winning numbers for any US state lottery on a results dashboard
- Track Powerball and Mega Millions jackpot growth over consecutive draws using
prev_jackpotandchangefields - Build a multi-state results page by batching state codes through
get_multiple_states_results - Analyze frequency of specific winning numbers over the past year using
get_historical_resultswithyearandmonthfilters - Alert users when a jackpot crosses a threshold by polling
get_jackpotsand comparingamountto a stored value - Enumerate all active games in a state with
get_state_gamesbefore building a game-selection UI
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does LotteryPost have an official public developer API?+
How far back does `get_historical_results` go?+
year/month combination outside that window will not return results. If you need deeper history, you can fork this API on Parse and revise it to extend the historical range.What does `get_jackpots` return and how is it scoped?+
get_jackpots takes no parameters and returns a globally ranked list of jackpots. Each record includes rank, amount, region, game, next_draw_date, prev_jackpot, and change. It covers both US and international lotteries that LotteryPost tracks, ranked by current jackpot size.Does the API return prize tier breakdowns (e.g., how many winners matched 4 of 5 numbers)?+
Can I look up results for a game slug without first calling `get_state_games`?+
powerball or megamillions directly to get_historical_results, but game availability varies by state. For state-specific games such as regional daily numbers draws, calling get_state_games first is the reliable way to confirm which slugs are valid for a given state code.