USA Mega APIusamega.com ↗
Access Mega Millions and Powerball results, historical drawings, prize breakdowns, odds, and state-by-state tax analysis via the usamega.com API.
What is the USA Mega API?
The usamega.com API exposes 5 endpoints covering Mega Millions and Powerball lottery data, including current and historical drawing results, per-tier prize breakdowns, winning odds, and state-by-state after-tax payout estimates. The get_latest_results endpoint returns the most recent winning numbers, multiplier, and next scheduled jackpot in a single call for both games. Response fields span annuity and cash values, Double Play numbers (Powerball), and drawing schedules.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d28795dd-8ad2-4cda-9c3a-6f8f389a2547/get_latest_results' \ -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 usamega-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.usa_mega_lottery_api import USAMega, Game, Lottery, Drawing, Detail, Tier, StatePayoff
mega = USAMega()
# Get latest results for all games
latest = mega.lotteries.latest()
# Access a specific game's lottery
powerball = mega.lottery(game=Game.POWERBALL)
# Get recent Powerball drawings
for drawing in powerball.results(max_results=5):
print(drawing.date, drawing.numbers, drawing.bonus_ball)
# Get detailed prize breakdown for a specific drawing
detail = powerball.drawing(year="2026", month="6", day="8")
print(detail.winning_numbers, detail.bonus_ball, detail.multiplier)
for table in detail.prize_tables:
print(table.title)
for p in table.prizes:
print(p.match, p.winners, p.prize)
# Get odds for Mega Millions
mm = mega.lottery(game=Game.MEGA_MILLIONS)
for tier in mm.odds():
print(tier.match, tier.prize, tier.odds)
# Get state-by-state jackpot tax analysis
for state in mm.jackpot_analysis():
print(state.state, state.average_annual_net, state.cash_option_net)
Fetches current winning numbers and next jackpot amounts for all games (Mega Millions and Powerball) from the homepage. Returns the most recent drawing numbers, bonus ball, multiplier, Double Play (Powerball only), and the next scheduled jackpot with annuity and cash values.
No input parameters required.
{
"type": "object",
"fields": {
"Powerball": "object with latest_drawing, double_play, and next_jackpot",
"Mega Millions": "object with latest_drawing and next_jackpot"
},
"sample": {
"data": {
"Powerball": {
"double_play": {
"numbers": [
"1",
"16",
"20",
"21",
"49"
],
"bonus_ball": "10"
},
"next_jackpot": {
"cash": "$106.1 Million",
"date": "Wed, Jun 10, 2026",
"annuity": "$238 Million"
},
"latest_drawing": {
"date": "Mon, Jun 8, 2026",
"numbers": [
"3",
"24",
"34",
"43",
"49"
],
"bonus_ball": "20",
"multiplier": "3x"
}
},
"Mega Millions": {
"next_jackpot": {
"cash": "$182.6 Million",
"date": "Fri, Jun 12, 2026",
"annuity": "$413 Million"
},
"latest_drawing": {
"date": "Tue, Jun 9, 2026",
"numbers": [
"9",
"30",
"36",
"38",
"40"
],
"bonus_ball": "3",
"multiplier": null
}
}
},
"status": "success"
}
}About the USA Mega API
Drawing Results and Jackpot Figures
get_latest_results returns a combined snapshot for both games: Powerball data includes latest_drawing, double_play, and next_jackpot (annuity and cash values); Mega Millions returns the same minus double_play. For deeper history, get_game_results accepts a game parameter ('mega-millions' or 'powerball') and an optional max_results integer, returning an array of drawing objects each with date, numbers, bonus_ball, multiplier, jackpot, and a url pointing to that drawing's detail page. Drawings are ordered newest-first.
Per-Drawing Prize Breakdowns
get_drawing_details takes game, year, month, and day as required inputs and returns the full prize structure for that specific drawing. The response includes winning_numbers, bonus_ball, multiplier, a summary object with annuity and cash jackpot values, and a prize_tables array. Each prize table carries a title (e.g. all-states pool, California-only, Double Play) and a prizes array listing winner counts and payout amounts per tier.
Odds and Tax Analysis
get_odds returns the complete prize tier table for a given game: each tier specifies match criteria, prize amount, and odds of winning, plus a schedule string showing draw days and time and an overall_odds field. get_jackpot_analysis shifts focus to net payouts: for each participating US state and territory it returns average_annual_net (annuity) and cash_option_net (lump sum) after federal and state taxes, along with jackpot_info, jackpot_amount_annuity, and the game identifier. Both endpoints require only the game parameter.
The USA Mega API is a managed, monitored endpoint for usamega.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when usamega.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 usamega.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 live Mega Millions and Powerball winning numbers on a lottery results dashboard using
get_latest_results. - Build a drawing history archive by paginating
get_game_resultswithmax_resultsand storing drawings in a database. - Render a per-drawing prize breakdown page using the
prize_tablesarray fromget_drawing_details, including California-specific and Double Play pools. - Show players their state's estimated after-tax take-home for annuity vs. lump sum using
get_jackpot_analysisstate objects. - Generate a prize odds reference table for both games from
get_oddstier data including match criteria and probability strings. - Alert subscribers when a jackpot crosses a threshold by monitoring the
next_jackpotannuity value returned byget_latest_results. - Compare historical jackpot sizes across drawings by extracting the
jackpotfield fromget_game_resultsover a date range.
| 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 usamega.com have an official public developer API?+
What does `get_drawing_details` return beyond just the winning numbers?+
get_drawing_details returns winning_numbers, bonus_ball, multiplier, a summary object with annuity and cash jackpot values, and a prize_tables array. Each entry in prize_tables has a title (such as all-states, California-only, or Double Play) and a prizes array listing winner counts and prize amounts per tier for that drawing date.Does the API cover state lottery games beyond Mega Millions and Powerball?+
game parameter on all endpoints accepts only 'mega-millions' and 'powerball'. You can fork this API on Parse and revise it to add endpoints for additional games if the source site carries that data.How current is the drawing data returned by `get_latest_results`?+
get_odds schedule field) is advisable.Does `get_jackpot_analysis` include tax breakdowns at the federal and state level separately?+
states array returns average_annual_net and cash_option_net as final net figures after combined federal and state taxes; individual federal vs. state deduction amounts are not broken out in the response. You can fork this API on Parse and revise it to surface those fields if the source page exposes them.