WWE API - Wrestling Sports
Pricing
from $0.01 / 1,000 results
WWE API - Wrestling Sports
Current WWE champions, roster, premium live events, match results, title histories and wrestler profiles for Raw, SmackDown and NXT, parsed live from Wikipedia on every run. Each row includes the source revision and CC BY-SA attribution.
Pricing
from $0.01 / 1,000 results
Rating
0.0
(0)
Developer
The Howlers
Maintained by CommunityActor stats
0
Bookmarked
15
Total users
0
Monthly active users
19 days ago
Last modified
Categories
Features
Share
WWE API (live from Wikipedia)
Current WWE data, fetched fresh on every run: champions, the active roster, premium live events, match results, the weekly show schedule, wrestler profiles, full championship histories and event cards for Raw, SmackDown, NXT, Evolve and WWE ID.
Where the data comes from
Every live run reads English Wikipedia through the public MediaWiki API (en.wikipedia.org/w/api.php) and parses the current revision of the relevant page. Nothing is cached in the actor and nothing is made up:
| Task | Wikipedia source |
|---|---|
superstars | List of WWE personnel (Main roster and Developmental roster sections) |
championships | List of current champions in WWE |
events | List of WWE pay-per-view and livestreaming supercards (past and upcoming tables) |
match_results | The event's own article (Results table) |
event_card | The event's own article (Matches table before the show, Results table after it) |
show_schedule | List of WWE television programming (Weekly television shows table) |
superstar_profile | The wrestler's article (infobox and lead paragraph), matched through the roster page |
championship_history | The title's reign table (the title article or its "List of ... Champions" page) |
Wikipedia is edited by volunteers, usually within hours of a title change or event, but it can lag or contain mistakes. If you need an official record, confirm with WWE.
Fields that Wikipedia does not provide are returned as null. For example, show_schedule returns the day and the network or platform when the Wikipedia sentence states them, but time and nextEpisodeDate are always null because Wikipedia does not list them.
Attribution and license (CC BY-SA 4.0)
Wikipedia text is licensed under CC BY-SA 4.0. Every live row carries what you need to attribute and reuse it:
{"sourceTitle": "List of current champions in WWE","sourceUrl": "https://en.wikipedia.org/wiki/List_of_current_champions_in_WWE","sourceRevisionId": 1381311181,"sourceRevisionTimestamp": "2026-10-21T14:40:44Z","sourceRevisionUrl": "https://en.wikipedia.org/w/index.php?oldid=1381311181","license": "CC BY-SA 4.0","licenseUrl": "https://creativecommons.org/licenses/by-sa/4.0/","attribution": "From the Wikipedia article \"List of current champions in WWE\" (revision 1381311181) by Wikipedia contributors, licensed under CC BY-SA 4.0. Author list: https://en.wikipedia.org/wiki/List_of_current_champions_in_WWE?action=history"}
If you republish the data, keep the attribution and share adaptations under the same license. This actor is not affiliated with WWE or the Wikimedia Foundation.
Quick start
{"task": "championships","brand": "all"}
Example row (trimmed):
{"task": "championships","success": true,"isLiveData": true,"brand": "Raw","championshipId": "world-heavyweight-championship","championship": "World Heavyweight Championship","champion": "Roman Reigns","reign": 1,"dateWon": "2026-04-19","daysHeldSinceDateWon": 186,"location": "Paradise, Nevada","notes": "Defeated CM Punk at WrestleMania 42 Night 2.","sourceRevisionId": 1381311181}
Tasks and output
The output is one dataset row per record. The dataset has a view per task in the Console.
| Task | One row per | Main fields |
|---|---|---|
superstars | Roster member | superstarId, ringName, realName, brand, division, roster, notes, wikipediaTitle |
championships | Active title | championshipId, championship, brand, champion, championMembers (tag teams), reign, dateWon, daysHeldSinceDateWon, daysRecognizedByWwe, location, notes |
events | Event in the chosen year | eventId, name, date, dateText, status (past or upcoming), venue, location, attendance, finalMatch, eventCategory (for example NXT-branded) |
match_results | Completed match | eventName, eventDate, segment (for example Night 1), matchNumber, result, winner, loser, method, stipulation, isTitleMatch, championship, matchTime |
event_card | Match on the card | Same as above; before the show status is announced and participants replaces result |
show_schedule | Weekly show | show, brands, dayOfWeek, networkOrPlatform, firstHeld, notes |
superstar_profile | One wrestler | name, brand, onCurrentWweRoster, birthName, birthDate, birthPlace, ringNames, billedHeight, billedWeight, billedFrom, trainedBy, debut, summary |
championship_history | Reign (oldest first) | era, reignNumberOverall, champion, dateWon, event, location, reign, daysHeld, daysRecognized, notes |
Notes on derived fields:
daysHeldSinceDateWonis computed at run time fromdateWon. WWE's own "days recognized" count can differ by a day or more and is returned separately when Wikipedia lists it.winner,loserandmethodare split from Wikipedia's "X defeated Y by Z" sentence. When a result does not use that wording (draws, no contests, ladder matches without a stated method), the parts that are not stated arenulland the full sentence is always inresult.isTitleMatchis true when the result names a defending champion with Wikipedia's "(c)" marker.
Input parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
task | string | superstars | One of the eight tasks above |
brand | string | all | all, raw, smackdown, nxt, evolve or id (superstars, championships, show_schedule) |
superstarId | string | - | Required for superstar_profile. A superstarId from the superstars task (for example cody-rhodes), a ring name slug for a past wrestler (the-undertaker) or an exact Wikipedia title |
championshipId | string | - | Required for championship_history. A championshipId from the championships task (for example undisputed-wwe-championship, nxt-championship) or an exact Wikipedia title |
eventId | string | - | For match_results and event_card. An eventId from the events task (for example wrestlemania-42) or an exact Wikipedia title. Empty means the latest completed event (results) or the next upcoming event (card) |
year | integer | current year | Year for the events task |
demoMode | boolean | false | Return the fixed December 2024 sample snapshot instead of live data (see below) |
webhookUrl | string | - | POST the rows to Zapier, Make, n8n or your own endpoint |
Errors are explicit and free
If something cannot be answered, the run returns a single error row with success: false, an errorType and a plain message, and no task event is charged:
| errorType | Meaning | Run status |
|---|---|---|
invalid_input | A required id is missing | Succeeded |
not_found | Unknown superstar, title or event, or an event with no results yet | Succeeded |
no_matching_rows | The brand filter matched nothing | Succeeded |
parse_failure | The Wikipedia page layout changed and the table could not be read | Failed |
source_unavailable | Wikipedia could not be reached after retries | Failed |
The actor never falls back to old or sample data when a live fetch fails.
Demo mode (sample data)
demoMode: true returns a small hand-made snapshot of WWE as of December 2024. It is out of date and not verified, and every row is labeled isSampleData: true and isLiveData: false. Demo runs make no task charge. Use it only to see the output shape.
Pricing
Pay per event. A task event is charged once per successful live run, no matter how many rows it returns:
| Event | When it is charged | Price |
|---|---|---|
| Actor start | Once when the run starts, one event per GB of memory (minimum one). At the default 1 GB of memory that is $0.10 per run | $0.10 per GB |
| WWE Superstars | Get roster by brand (Raw/SmackDown/NXT) | $0.002 |
| WWE Championships | Fetch all current champions and titles | $0.002 |
| WWE Events | Get premium live events for a year | $0.002 |
| WWE Match Results | Get match results from an event | $0.003 |
| WWE Show Schedule | Fetch Raw/SmackDown/NXT schedule | $0.002 |
| WWE Superstar Profile | Get detailed superstar bio and stats | $0.003 |
| WWE Championship History | Get title lineage and past holders | $0.003 |
| WWE Event Card | Get full match card for an event | $0.003 |
| Result | Each item written to the default dataset | $0.00001 |
Platform events also apply to every run, including demo and error runs: Actor Start at $0.10 per GB of run memory (minimum one event) and $0.00001 per dataset row. The actor needs very little memory, so running it with 1 GB or less keeps the start fee to a single $0.10 event.
Troubleshooting
not_found for a superstar: use the superstarId exactly as the superstars task returns it, or pass the Wikipedia article title (for example Raquel Rodriguez (wrestler)).
match_results says there are no results yet: the event has not happened or Wikipedia has not added the Results table. Use event_card to get the announced matches.
A value looks wrong: check the sourceRevisionUrl on the row. It shows the exact Wikipedia revision the actor read.
Built by John Rippy | Actor Arsenal