Com APIsportybet.com.ng ↗
Access SportyBet Nigeria pre-match odds for football, basketball, and ice hockey. Book bets and retrieve shareable booking codes via 8 structured endpoints.
What is the Com API?
This API exposes 8 endpoints covering SportyBet Nigeria's pre-match betting markets and bet booking workflow. Use get_prematch_football_events to pull 1X2 odds across paginated football fixtures, get_prematch_football_all_markets to retrieve every available market on a fixture (600+ markets, 4,000+ outcomes per event), and book_bet to submit selections and receive a shareable booking code with a deadline timestamp and a direct share URL.
curl -X POST 'https://api.parse.bot/scraper/8e652912-d760-4522-85ce-071e539a9c12/book_bet' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"selections": "[{\"eventId\":\"sr:match:72221154\",\"marketId\":\"1\",\"outcomeId\":\"1\"}]"
}'Book a bet by providing one or more selections (event, market, outcome). Each selection identifies a specific outcome on a specific market for a specific event across football, basketball, or ice hockey. Returns a booking code that can be shared across devices or with other users to load the same betslip. Does not require authentication or stake — it only reserves the selections. The booking code expires when the earliest selected event starts. Supports all markets: 1X2 (marketId '1', outcomeId '1'/'2'/'3'), Over/Under (marketId '18' or '225', outcomeId '12'/'13', specifier 'total=2.5'), Asian Handicap (marketId '16', specifier 'hcp=-1.5'), Double Chance (marketId '10'), Draw No Bet (marketId '11'), GG/NG (marketId '29'), Correct Score (marketId '45'), Half Time/Full Time (marketId '47'), 1st Half 1X2 (marketId '60'), Handicap (marketId '14'/'223', specifier 'hcp=0:1' or 'hcp=-5.5'), Winner incl. overtime (marketId '219'), and Team Total (marketId '227'/'228', specifier 'total=82.5').
| Param | Type | Description |
|---|---|---|
| selectionsrequired | string | JSON array of selection objects. Each object must contain: eventId (e.g. 'sr:match:72221154'), marketId (e.g. '1' for 1X2, '18' for Over/Under, '10' for Double Chance, '11' for Draw No Bet, '14' for Handicap, '16' for Asian Handicap, '29' for GG/NG, '45' for Correct Score, '47' for HT/FT, '60' for 1st Half 1X2, '219' for Winner incl. OT, '223' for Handicap incl. OT, '225' for Over/Under incl. OT), outcomeId (e.g. '1' for Home, '2' for Draw, '3' for Away, '12' for Over, '13' for Under, '4' for Home winner, '5' for Away winner). Optional: specifier (e.g. 'total=2.5' for Over/Under, 'hcp=-1.5' for Asian Handicap, 'hcp=0:1' for European Handicap, 'total=82.5' for Team Total). |
{
"type": "object",
"fields": {
"deadline": "integer — Unix timestamp (ms) when the booking expires",
"outcomes": "array of outcome objects with match/odds details for each selection",
"shareURL": "string — full URL that loads the betslip when visited",
"shareCode": "string — the booking code to share or load on other devices",
"unavailableOutcomes": "array of outcomes that could not be booked (e.g. suspended markets)"
},
"sample": {
"data": {
"deadline": 1788202800000,
"outcomes": [
{
"odds": "1.20",
"sport": "Football",
"gameId": "39515",
"eventId": "sr:match:72221154",
"category": "England",
"marketDesc": "1X2",
"tournament": "Premier League",
"matchStatus": "Not start",
"awayTeamName": "Coventry City",
"homeTeamName": "Arsenal",
"selectedOutcome": "Home",
"estimateStartTime": 1787338800000
}
],
"shareURL": "http://www.sportybet.com/ng/?shareCode=J6PPYB",
"shareCode": "J6PPYB",
"unavailableOutcomes": []
},
"status": "success"
}
}About the Com API
Odds Data Coverage
The API covers three sports. Football endpoints expose markets including 1X2, Double Chance, Draw No Bet, Over/Under, Asian Handicap, Correct Score, Half Time/Full Time, corners, bookings, shots, and half- and minute-range specials. get_prematch_football_markets and get_prematch_football_all_markets return a flat array of outcome rows — one row per selectable outcome — each carrying eventId, marketId, marketDesc, marketGroup, outcomeId, outcomeDesc, odds, and specifier. Basketball outcomes cover Winner incl. overtime, Handicap, Over/Under, Team Total Points, and a full set of 1st-Half and 1st-Quarter markets. Ice hockey outcomes include 1X2/Winner, Puck Line, Over/Under Total Goals, Team Total Goals, Double Chance, GG/NG, and Correct Score.
Filtering and Pagination
All listing endpoints accept page and page_size for pagination. get_prematch_football_events, get_prematch_football_markets, get_prematch_basketball_events, and get_prematch_ice_hockey_events accept a tournament parameter for case-insensitive substring filtering on league name (e.g. 'Premier League', 'NBA', 'NHL'). The market-level endpoints also accept a market parameter to narrow results to a specific market type. An hours parameter on basketball, ice hockey, and football-markets endpoints limits results to events with kickoffs within the next N hours.
Booking Workflow
book_bet accepts a selections array where each object includes eventId, marketId, outcomeId, and odds. The response returns a shareCode (e.g. N4C1ZD), a shareURL that opens the betslip directly on the site, a deadline Unix timestamp (ms) indicating when the code expires, and an unavailableOutcomes array listing any selections that could not be booked due to suspended markets. The get_booking endpoint accepts a share_code and returns the full betslip — including per-selection fields like tournament, homeTeamName, awayTeamName, kickoffTime, and current odds — plus a computed totalOdds (product of non-void selection odds) and a bookingSettlement status of PENDING, WON, LOST, VOID, or UNKNOWN.
Full Market Depth
get_football_event_markets takes a single event_id (format sr:match:<digits>) and returns every market and outcome the site currently lists for that fixture, along with marketCount, matchStatus, gameId, category, tournament, and kickoffTime. get_prematch_football_all_markets pages across fixtures (1–3 per page) and aggregates all outcomes for each fixture in the window; a failedEvents array identifies any fixtures whose market list could not be fetched.
The Com API is a managed, monitored endpoint for sportybet.com.ng — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when sportybet.com.ng 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 sportybet.com.ng 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?+
- Build an odds comparison tool tracking SportyBet Nigeria lines across Premier League and La Liga fixtures using get_prematch_football_events
- Programmatically book multi-selection accumulators via book_bet and store the returned shareCode for user retrieval
- Monitor Over/Under market odds shifts on upcoming NBA games using get_prematch_basketball_events with the market filter
- Retrieve a full betslip by share code with get_booking to display selections, current odds, and settlement status in a custom UI
- Scrape every corner and booking market on a specific match using get_football_event_markets to feed a specials-betting dashboard
- Filter NHL pre-match Puck Line outcomes with get_prematch_ice_hockey_events to power an ice hockey betting feed
- Enumerate all 600+ markets on a Champions League fixture with get_prematch_football_all_markets for deep market analysis
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.