Recommendations API
Get player-profile based racket recommendations.
Not live
POST /api/v1/recommendations is not live on https://www.padelful.com. A request to it returns 404.
This page shows the planned partner contract. The contract can change before the endpoint goes live.
The live endpoints are the Rackets API endpoints only.
If you need this endpoint, send an email to partners@padelful.com.
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 body
{
"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.