Rackets API

GET /api/v1/rackets

Returns a paginated list of rackets.

Query parameters

query (string, optional): fuzzy match by model, brand, or title
brand (string, optional)
shape (enum, optional): Round | Teardrop | Diamond
minRating (number, optional): 0 to 10
locale (enum, optional): en | es (default en)
limit (number, optional): 1 to 2000 (default 50)
offset (number, optional): default 0
includeJsonLd (boolean, optional): default false

Example request

curl "https://padelful.com/api/v1/rackets?locale=en&shape=Round&minRating=8&limit=3&includeJsonLd=true"

Example response

{
  "data": {
    "rackets": [
      {
        "slug": "example-racket",
        "title": "Example Racket",
        "brand": "Bullpadel",
        "rating": "8.6",
        "shape": "Round",
        "jsonLd": {
          "@context": "https://schema.org",
          "@type": "Product"
        }
      }
    ],
    "pagination": {
      "total": 120,
      "limit": 3,
      "offset": 0,
      "hasMore": true,
      "nextOffset": 3
    }
  },
  "meta": {
    "requestId": "req_123",
    "version": "v1",
    "locale": "en",
    "generatedAt": "2026-02-11T12:00:00.000Z"
  }
}

GET `/api/v1/rackets/{slug}`

Returns one racket by slug.

Query parameters

locale (enum, optional): en | es (default en)

Example request

curl "https://padelful.com/api/v1/rackets/bullpadel-hack-03-2025?locale=en"

Not found response

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Racket with slug 'unknown' was not found",
    "requestId": "req_123"
  }
}

On this page