API Documentation

v2 Latest Live

Complete reference for the Bet365Soft Sportsbook v2 — improved response structure, enriched data fields, and faster delivery.

View v1 Settlement API

Getting Started

Overview

Bet365Soft v2 delivers enriched sports data with improved latency, structured error codes, and an expanded data schema.

Real-Time Inplay

Sub-second live odds and match state updates across all supported sports.

Secure & Reliable

HTTPS-only, API-key authentication, 99.95% uptime SLA.

3,600 Req/Hour

Generous throughput for production sportsbook platforms.

Enriched JSON

v2 adds metadata fields, pagination, and extended market coverage.

Version Highlights

What's New in v2

Key improvements over API v1.

New Features

Pagination support on all list endpoints
Expanded market IDs and bet types
Player statistics in match events
Live score push via polling improvements
Structured error codes with detail messages

Performance Gains

40% faster average response time
Gzip compression enabled by default
Edge caching for static sport lists
Reduced payload size (~25% smaller)
CDN distribution across 12 regions

v1 vs v2 Feature Comparison

Feature	API v1	API v2
Pagination
Player Stats in Events
Structured Error Codes
Gzip Compression
Expanded Market IDs
Basic Sports Endpoints
History Endpoints
JSON Response Format

Security

Authentication

All requests must include your API key as a query parameter.

Pass your API key using the apikey query parameter on every request:

            
            GET https://w7api.com/sports/api/v2/sports?apikey=YOUR_API_KEY
          

Keep your API key private. Never expose it in frontend JavaScript, public repositories, or client-side code. Use a server-side proxy to protect your key in production.

Get Your Key

Rotate Regularly

Rotate keys every 90 days for best security.

Keep It Secret

Store in environment variables, never in source code.

Configuration

Base URL

All v2 API calls use the following base URL and directory paths.

Base URL https://w7api.com/sports

Sportsbook Directory

                
                Base: https://w7api.com/sports

                Dir : /api/v2

                Full: https://w7api.com/sports/api/v2/{endpoint}

History Directory

                
                Base: https://w7api.com/sports

                Dir : /history/v2

                Full: https://w7api.com/sports/history/v2/{endpoint}

Sportsbook

Sportsbook Endpoints /api/v2

Directory: https://w7api.com/sports/api/v2

GET /sports v2 List all available sports

Returns a list of all sports available in the platform with their IDs and metadata.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API authentication key

GET https://w7api.com/sports/api/v2/sports?apikey=XXXXXXXXXX

GET /inplay v2 Live in-play events by sport

Returns all currently live (in-play) events for a given sport, including enriched odds and scoreline data.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`sid`	integer	Required	Sport ID (e.g. 1 = Football)
`limit`	integer	Optional	Results per page, default 50 (v2 only)

                  
GET https://w7api.com/sports/api/v2/inplay?apikey=XXXXXXXXXX&sid=1
                

GET /inplayEvent v2 Single live event detail

Returns full detail for a single live event including all markets, odds, timeline, and player stats (v2 new field).

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`id`	string	Required	Event / match ID

                  
GET https://w7api.com/sports/api/v2/inplayEvent?apikey=XXXXXXXXXX&id=XXXXXXXXX
                

GET /upcoming v2 Upcoming events by date range

Returns scheduled upcoming matches filtered by sport and date range.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`sid`	integer	Required	Sport ID
`fromDate`	string	Required	Start date `YYYY-MM-DD`
`toDate`	string	Required	End date `YYYY-MM-DD`
`limit`	integer	Optional	Results per page, default 50 (v2 only)

                  
GET https://w7api.com/sports/api/v2/upcoming?apikey=XXXXXXXXXX&sid=1&fromDate=2025-06-01&toDate=2025-06-07
                

GET /leagues v2 Leagues by sport

Returns leagues and competitions for a given sport, including country metadata and season info (v2 enriched).

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`sid`	integer	Required	Sport ID

              
GET https://w7api.com/sports/api/v2/leagues?apikey=XXXXXXXXXX&sid=1
            

GET /prematch v2 Pre-match events for a league

Returns all pre-match events for a specific sport and league combination.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`sid`	integer	Required	Sport ID
`lid`	string	Required	League ID

                  
GET https://w7api.com/sports/api/v2/prematch?apikey=XXXXXXXXXX&sid=1&lid=XXXXXX
                

GET /prematchEvent v2 Single pre-match event detail

Returns full markets and odds for a single pre-match event. v2 includes expanded market groups.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`id`	integer	Required	Event / match ID

              
GET https://w7api.com/sports/api/v2/prematchEvent?apikey=XXXXXXXXXX&id=XXXXXXXXXX
            

GET /topMatch v2 Top featured matches

Returns editorially featured top matches — filter by live or line (pre-match).

Parameter	Type	Required	Values
`apikey`	string	Required	Your API key
`status`	string	Required	`"Live"` or `"Line"`

                  
# Live top matches
GET https://w7api.com/sports/api/v2/topMatch?apikey=XXXXXXXXXX&status=Live

# Pre-match top matches
GET https://w7api.com/sports/api/v2/topMatch?apikey=XXXXXXXXXX&status=Line

GET /search v2 Search events by text

Full-text search across live and pre-match events. v2 improves fuzzy matching accuracy.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`status`	string	Required	`"Live"` or `"Line"`
`text`	string	Required	Search keyword (e.g. "England")

                  
GET https://w7api.com/sports/api/v2/search?apikey=XXXXXXXXXX&status=Live&text=England
                

GET /tournaments v2 All tournaments

Returns all available tournaments across sports.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key

GET https://w7api.com/sports/api/v2/tournaments?apikey=XXXXXXXXXX

GET /tournamentWinner v2 Tournament winner odds

Returns outright / tournament winner markets for a specific league.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`lid`	integer	Required	League ID

              
GET https://w7api.com/sports/api/v2/tournamentWinner?apikey=XXXXXXXXXX&lid=XXXXXXXXX
            

GET /resultByEvent v2 Final result by event ID

Returns the final result and all settled market outcomes for a completed event.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`id`	integer	Required	Event / match ID

              
GET https://w7api.com/sports/api/v2/resultByEvent?apikey=XXXXXXXXXX&id=XXXXXXXXX
            

History

History Endpoints /history/v2

Directory: https://w7api.com/sports/history/v2

GET /summary v2 Game summary by ID

Returns a full match summary including timeline, score, lineups, and statistics. // Game ID required

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`id`	integer	Required	Game ID

              
GET https://w7api.com/sports/history/v2/summary?apikey=XXXXXXXXXX&id=XXXXXXXXXXXXXXXX
// id = Game ID

GET /team v2 Team history & stats

Returns historical performance data for a team. v2 adds form guide and head-to-head stats. // Team ID required

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`id`	integer	Required	Team ID

              
GET https://w7api.com/sports/history/v2/team?apikey=XXXXXXXXXX&id=XXXXXXXXXXXXXXXX
// id = Team ID

GET /player v2 Player history & stats

Returns career history and recent performance stats for a player. // Player ID required

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`id`	integer	Required	Player ID

              
GET https://w7api.com/sports/history/v2/player?apikey=XXXXXXXXXX&id=XXXXXXXXXXXXXXXX
// id = Player ID

GET /tournamentInfo v2 Tournament & season info

Returns tournament standings, top scorers, and season results. Requires both tournament ID and season ID.

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`id`	string	Required	Tournament ID
`seasonId`	string	Required	Season ID

                  
GET https://w7api.com/sports/history/v2/tournamentInfo?apikey=XXXXXXXXXX&id=XXXXXXXXXXXXXXXX&seasonId=XXXXXXXXX
// id = Tournament ID, seasonId = Season ID

GET /stageInfo v2 Stage / round information

Returns results and standings for a specific stage or round within a tournament. // Stage ID required

Parameter	Type	Required	Description
`apikey`	string	Required	Your API key
`id`	integer	Required	Stage ID

              
GET https://w7api.com/sports/history/v2/stageInfo?apikey=XXXXXXXXXX&id=XXXXXXXXXXXXXXXX
// id = Stage ID

Reference

Status Handling

Response true

{ "success": true, "data": "[ ... ]", }

Response false

{ "success": false, "error": "Error message", }

Upgrade

Migration Guide

Migrating from API v1 to v2 is straightforward — only the directory path changes.

Backward compatible: All query parameters from v1 work identically in v2. Simply update your base directory from /api/v1 to /api/v2 and /history/v1 to /history/v2.

Old — API v1

https://w7api.com/sports/api/v1/sports
https://w7api.com/sports/history/v1/summary
              

New — API v2

https://w7api.com/sports/api/v2/sports
https://w7api.com/sports/history/v2/summary
              