Data Service
Cost
Basic |
Current season |
100 requests/day |
€25,00 monthly |
|
Extra |
Current season |
1.000 requests/day |
€95,00 monthly |
|
Premium |
All |
10.000 requests/day |
€575,00 monthly |
The monthly subscription can be canceled at any time through your Stripe account or sending an mail to bdfutbol@gmail.com specifying your username or email.
If you prefer a custom budget, please contact us by mail at bdfutbol@gmail.com or with the contact form
API Main Url
The base url of the API is https://photoapi.bdfutbol.com
Authentication
All API requests require authentication via a bearer token. To obtain a token, you must log in using the /login endpoint.
Login Endpoint
POST /login
Request Body:
{
"email": "test@example.com",
"password": "password123"
}
Response:
{
"message": "Login successful",
"token": "token"
}
Usage
Once authenticated, include the token in the Authorization header of your requests:
Authorization: Bearer token
Get Photo
The /photos endpoint allows retrieving player photos using different search parameters. Depending on the specificity of the provided parameters, the response may either return a single photo file or a list of candidate photos.
Search Options
You can request a photo in the following ways:
- By player ID
- By search criteria (all optional):
- Player ID
- Player name
- Team ID
- Team name
- Shirt number
- By photo ID
- If the parameters uniquely identify a single player, the response will return its photo file.
- If multiple players match the given parameters (e.g., multiple players named 'Smith'), the response will contain a list of candidates, each with a unique
photoId. You can use this ID to make another request for a specific photo.
Photos Endpoint
POST /photos
Request Body:
{
"personId": "123",
"name": "Messi",
"season": "2023-24",
"team": "Barcelona",
"teamId": "1",
"number": "10",
"photoId": "9876"
}
Single Photo Response
If a unique match is found, the API responds with the photo file directly.
[Binary Photo File]
Multiple Candidates Response
If multiple matches are found, the response will contain a list of possible photos:
{
"photos": [
{
"photoId": "9876",
"season": "2023-24",
"team": "Barcelona"
}
]
}
Use the photoId from the response to make another request to obtain a specific photo.
Notes
- Ensure the
Authorization token is included in the header for all requests.
- When providing search criteria, more specific parameters increase the chance of retrieving a single result.
- The API follows RESTful principles, and all responses adhere to standard HTTP status codes:
200 OK – Request successful400 Bad Request – Invalid request parameters401 Unauthorized – Missing or invalid token404 Not Found – No matching photo found500 Internal Server Error – Unexpected error
Authorization token is included in the header for all requests.200 OK– Request successful400 Bad Request– Invalid request parameters401 Unauthorized– Missing or invalid token404 Not Found– No matching photo found500 Internal Server Error– Unexpected error