Padelful Docs

Compare API

Compare 2 to 4 rackets in a single request.

POST /api/v1/compare

Compares up to 4 rackets by slug and returns normalized comparison data.

Request body

  • slugs (string[], required): 2 to 4 racket slugs
  • locale (enum, optional): en | es (default en)

Example request

curl -X POST "https://padelful.com/api/v1/compare" \
  -H "Content-Type: application/json" \
  -d '{
    "locale": "en",
    "slugs": [
      "babolat-technical-viper-2025",
      "bullpadel-hack-03-2025"
    ]
  }'

Example response

{
  "data": {
    "success": true,
    "rackets": [
      {
        "slug": "babolat-technical-viper-2025",
        "model": "Technical Viper",
        "rating": "8.7"
      },
      {
        "slug": "bullpadel-hack-03-2025",
        "model": "Hack 03",
        "rating": "8.6"
      }
    ],
    "comparison": {
      "summary": "Comparing Technical Viper and Hack 03",
      "content": "..."
    }
  },
  "meta": {
    "requestId": "req_123",
    "version": "v1",
    "locale": "en",
    "generatedAt": "2026-02-11T12:00:00.000Z"
  }
}

Validation errors

If the payload is invalid, server returns 400 with code: INVALID_BODY.

On this page