SMACKDOWNONYOU

The magazine, in JSON.

The public API makes the magazine's published content available to readers and developers. Start with the OpenAPI specification.

Public read endpoints

  • GET /api/v1/posts — published articles.
  • GET /api/v1/posts/{slug} — one published article.
  • GET /api/v1/categories — category names and descriptions.
  • GET /api/v1/wrestlers — wrestler profiles.
  • GET /api/v1/wrestlers/{slug} — a profile with selected indexed match results and statistics.
  • GET /api/v1/schedule — recurring television guidance.
  • GET /api/v1/events — dated organizer event listings, with promotion, date, city and show filters.
  • GET /api/v1/events/{slug} — one sourced event and its freshness status.
  • GET /api/v1/promotions — covered promotions, official calendars and import scope.

Collection endpoints accept page and per_page. The default page size is 20; the maximum is 100. Article collections also accept category and q. Wrestler collections accept promotion.

GET /api/v1/posts?category=aew&page=1&per_page=10
GET /api/v1/wrestlers/adam-page
GET /api/v1/events?promotion=tna&per_page=10
GET /api/v1/schedule

Successful responses use a data field. Paginated collections include meta with page information. Errors use an error object containing a code and message.

Account tokens

Public content does not require an account token. Account access uses POST /api/v1/auth/token with a JSON body containing your email and password and an optional token name. A configured anti-spam check may require additional fields; consult the specification. Store the returned token securely and send it as Authorization: Bearer YOUR_TOKEN. Tokens expire and are stored as hashes by the application.

GET /api/v1/me returns the authenticated account. DELETE /api/v1/auth/token revokes the token used for that request. You can also revoke your tokens through your account. Never put a password or token in a public URL, repository or client-side application.

Limits and content context

Event dates are the organizer’s calendar dates. time_label preserves the source wording and must not be treated as a UTC timestamp or television airtime. Sources are checked nightly; retain official source links and warn readers when stale is true. Event filters include promotion, from, to (ISO dates) and q (title, city or venue).

The API currently limits general requests to 120 per minute per derived client identifier, with tighter controls for authentication. A 429 response includes Retry-After. Respect that interval and avoid repeated parallel retries.

Wrestler statistics have the scope indexed_matches: they describe this collection, not career totals or official promotion standings. Schedule entries marked recurring are regular slots, not confirmation of a future episode or match card. Preserve those distinctions in anything you build.

Public API access does not grant additional content or image rights. Preserve source and license credits, follow the terms of use, and contact the operator about broader reuse or a technical issue.

THE RINGSIDE READ

Good wrestling. Great reading.

Features, match history and a little perspective, straight to your inbox.

SmackDownOnYou app icon

Your seat. One tap away.

On iPhone or iPad, open this site in Safari, tap Share, then choose Add to Home Screen. On Android, use your browser’s Install app option.