Recommendations API
Get player-profile based racket recommendations.
POST /api/v1/recommendations
Returns top recommended rackets based on player profile.
Request body
level(enum, required):beginner|intermediate|advancedplayStyle(enum, required):control|power|balancedbudget(number, optional): max budget in EURlocale(enum, optional):en|es(defaulten)
Example request
curl -X POST "https://padelful.com/api/v1/recommendations" \
-H "Content-Type: application/json" \
-d '{
"level": "intermediate",
"playStyle": "balanced",
"budget": 220,
"locale": "en"
}'Example response
{
"data": {
"recommendations": [
{
"slug": "example-racket",
"model": "Example Model",
"matchReason": "Great balance of power and control"
}
],
"criteria": {
"level": "intermediate",
"playStyle": "balanced",
"budget": 220
}
},
"meta": {
"requestId": "req_123",
"version": "v1",
"locale": "en",
"generatedAt": "2026-02-11T12:00:00.000Z"
}
}Validation errors
If required fields are missing or invalid, server returns 400 with code: INVALID_BODY.