WWE API - Wrestling Sports avatar

WWE API - Wrestling Sports

Pricing

from $0.01 / 1,000 results

Go to Apify Store
WWE API - Wrestling Sports

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

The Howlers

Maintained by Community

Actor stats

0

Bookmarked

15

Total users

0

Monthly active users

19 days ago

Last modified

Features

Limited permissions

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:

TaskWikipedia source
superstarsList of WWE personnel (Main roster and Developmental roster sections)
championshipsList of current champions in WWE
eventsList of WWE pay-per-view and livestreaming supercards (past and upcoming tables)
match_resultsThe event's own article (Results table)
event_cardThe event's own article (Matches table before the show, Results table after it)
show_scheduleList of WWE television programming (Weekly television shows table)
superstar_profileThe wrestler's article (infobox and lead paragraph), matched through the roster page
championship_historyThe 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.

TaskOne row perMain fields
superstarsRoster membersuperstarId, ringName, realName, brand, division, roster, notes, wikipediaTitle
championshipsActive titlechampionshipId, championship, brand, champion, championMembers (tag teams), reign, dateWon, daysHeldSinceDateWon, daysRecognizedByWwe, location, notes
eventsEvent in the chosen yeareventId, name, date, dateText, status (past or upcoming), venue, location, attendance, finalMatch, eventCategory (for example NXT-branded)
match_resultsCompleted matcheventName, eventDate, segment (for example Night 1), matchNumber, result, winner, loser, method, stipulation, isTitleMatch, championship, matchTime
event_cardMatch on the cardSame as above; before the show status is announced and participants replaces result
show_scheduleWeekly showshow, brands, dayOfWeek, networkOrPlatform, firstHeld, notes
superstar_profileOne wrestlername, brand, onCurrentWweRoster, birthName, birthDate, birthPlace, ringNames, billedHeight, billedWeight, billedFrom, trainedBy, debut, summary
championship_historyReign (oldest first)era, reignNumberOverall, champion, dateWon, event, location, reign, daysHeld, daysRecognized, notes

Notes on derived fields:

  • daysHeldSinceDateWon is computed at run time from dateWon. WWE's own "days recognized" count can differ by a day or more and is returned separately when Wikipedia lists it.
  • winner, loser and method are 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 are null and the full sentence is always in result.
  • isTitleMatch is true when the result names a defending champion with Wikipedia's "(c)" marker.

Input parameters

ParameterTypeDefaultDescription
taskstringsuperstarsOne of the eight tasks above
brandstringallall, raw, smackdown, nxt, evolve or id (superstars, championships, show_schedule)
superstarIdstring-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
championshipIdstring-Required for championship_history. A championshipId from the championships task (for example undisputed-wwe-championship, nxt-championship) or an exact Wikipedia title
eventIdstring-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)
yearintegercurrent yearYear for the events task
demoModebooleanfalseReturn the fixed December 2024 sample snapshot instead of live data (see below)
webhookUrlstring-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:

errorTypeMeaningRun status
invalid_inputA required id is missingSucceeded
not_foundUnknown superstar, title or event, or an event with no results yetSucceeded
no_matching_rowsThe brand filter matched nothingSucceeded
parse_failureThe Wikipedia page layout changed and the table could not be readFailed
source_unavailableWikipedia could not be reached after retriesFailed

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:

EventWhen it is chargedPrice
Actor startOnce 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 SuperstarsGet roster by brand (Raw/SmackDown/NXT)$0.002
WWE ChampionshipsFetch all current champions and titles$0.002
WWE EventsGet premium live events for a year$0.002
WWE Match ResultsGet match results from an event$0.003
WWE Show ScheduleFetch Raw/SmackDown/NXT schedule$0.002
WWE Superstar ProfileGet detailed superstar bio and stats$0.003
WWE Championship HistoryGet title lineage and past holders$0.003
WWE Event CardGet full match card for an event$0.003
ResultEach 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