Introduction
The bescoutd API allows you to programmatically access our elite football intelligence, including player valuations (xTV), scouting reports, and real-time market trends.
RESTful Standards
Our API is organized around REST and uses standard HTTP response codes.
Authentication
Authenticate your account by including your secret key in the header of every request.
Header: Authorization: Bearer [[API_KEY]]
All API requests must be made over HTTPS. Calls made over plain HTTP will fail.
Players
List Players
Returns a list of players matching your search criteria.
GET /v1/players
Parameters
| Name | Description |
|---|---|
| limit integer | The number of items to return (1-100). |
| search string | Filter by player name or league. |
Clubs
List Clubs
Retrieve a list of clubs currently active in the marketplace.
GET /v1/clubs
Error Codes
bescoutd uses conventional HTTP response codes to indicate the success or failure of an API request.
| 400 | The request was unacceptable. |
| 401 | No valid API key provided. |
| 500 | Something went wrong on our end. |