API Overview

Base URL

• Production: https://padelful.com

Versioning

• Current version: v1
• Prefix all endpoints with /api/v1

Response envelope

Successful responses:

{
  "data": {},
  "meta": {
    "requestId": "req_123",
    "version": "v1",
    "locale": "en",
    "generatedAt": "2026-02-11T12:00:00.000Z"
  }
}

Error responses:

{
  "error": {
    "code": "INVALID_QUERY",
    "message": "Invalid query parameters",
    "details": {},
    "requestId": "req_123"
  }
}

Locale

• Supported locales: en, es
• Default locale: en

CORS

• API is CORS-enabled for server-to-server and browser integrations.

Rate limits

• Rate limiting is enabled for anonymous traffic.
• On limit hit, server returns 429 and a Retry-After header.

LLM consumption tips

• Prefer deterministic filters (brand, shape, minRating) over free-text only.
• Use includeJsonLd=true for richer product context.
• Cache list results and only re-fetch details on demand.