lotterypost.com APIlotterypost.com ↗
Fetch lottery results, historical drawings, jackpot amounts, and game listings for US states and major worldwide lotteries via the LotteryPost.com API.
curl -X GET 'https://api.parse.bot/scraper/76d00006-2092-4ae3-81d2-58e8ccd84550/get_state_results?state=CA' \ -H 'X-API-Key: $PARSE_API_KEY'
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). |
{
"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, May 13, 2026",
"next_drawing": "Thu, May 14, 2026, 2:30 pmEastern Time (GMT-5:00)4 hours from now",
"bonus_numbers": [],
"winning_numbers": [
"0",
"0",
"3"
],
"drawing_timestamp": "2026-05-13T14:30-05:00"
},
{
"game_id": "143",
"game_name": "Lotto",
"game_slug": "lotto",
"drawing_date": "Wednesday, May 13, 2026",
"next_drawing": "Sat, May 16, 2026, 8:15 pmEastern Time (GMT-5:00)2 days from now",
"next_jackpot": "$2.3 Million",
"bonus_numbers": [
"41"
],
"jackpot_change": "$100,000",
"winning_numbers": [
"10",
"20",
"38",
"40",
"44",
"56"
],
"drawing_timestamp": "2026-05-13T20:15-05:00"
}
]
},
"status": "success"
}
}About the lotterypost.com 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.
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.
- 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 | 250 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.