Sport Shorthand Routes

Convenience routes that use sport slugs instead of numeric IDs

V5 ships sport-slug shortcuts for the two most-used endpoints. The response shape is identical to the canonical endpoints.

Prematch top events

GET /api/v1/{sport}/top
GET /api/v1/{sport}/top?count=10

Equivalent to /api/v1/events/top?sport={id}.

Live events

GET /api/v1/{sport}/live

Equivalent to /api/v1/live/events?sport={id}.

Examples

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/football/top?count=10"

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/tennis/live"

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/cricket/top"

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v5/ice-hockey/live"

Supported slugs

football, soccer, hockey, ice-hockey, basketball, tennis, baseball, volleyball, rugby, handball, boxing, table-tennis, american-football, futsal, darts, beach-soccer, f1, formula-1, australian-rules, beach-volleyball, snooker, esports, golf, cricket, ufc.

For any sport not in the slug list, use the numeric ?sport={id} form on the canonical endpoints.