Playground

See it. Then build it.

See a sample request and response for each endpoint, and what the scores, warnings and confidence notes mean for your product. The samples are real API output, trimmed; get a key to send your own requests.

Get an API key API docs

Request

POST /api/v1/recommendations

{
  "golferProfile": {
    "handicap": 14,
    "swingSpeed": 96,
    "miss": "Slice",
    "trajectory": "Mid",
    "budget": "$300–600"
  },
  "categories": [
    "driver"
  ],
  "limit": 1
}

Response

Sample response · get a key to run it live

sample

{
  "data": {
    "golferProfile": {
      "swingSpeed": 96,
      "handicap": 14,
      "miss": "Slice",
      "trajectory": "Mid",
      "budget": "$300–600"
    },
    "recommendations": [
      {
        "category": "driver",
        "products": [
          {
            "productId": "driver:ben-hogan-golf:ptx-max:2025",
            "product": {
              "id": "driver:ben-hogan-golf:ptx-max:2025",
              "displayName": "Ben Hogan Golf PTx MAX",
              "year": 2025,
              "lifecycleStatus": "current",
              "confidence": {
                "verificationTier": "verified"
              }
            },
            "totalScore": 64,
            "matchScore": 64,
            "rank": 1,
            "rawScore": 64,
            "maxScore": 100,
            "flags": [],
            "scoreBreakdown": {
              "categoryFit": 12,
              "speedFit": 13,
              "handicapFit": 13,
              "budgetFit": 10,
              "launchSpinFit": 8,
              "forgivenessWorkabilityFit": 10,
              "shaftWeightKickFit": 0,
              "recencyFit": 9
            },
            "reasons": [
              "Category matches the golfer profile.",
              "Swing speed falls close to the product fit window.",
              "Handicap range is aligned with the product target player.",
              "Launch and spin bias support the stated ball-flight needs.",
              "Forgiveness/workability profile is appropriate for the player.",
              "Price tier fits the stated budget."
            ],
            "warnings": [],
            "rankingReasons": [
              {
                "signal": "category",
                "points": 15,
                "max": 25,
                "note": "It is a max forgiveness head, one of the types that suit you"
              },
              {
                "signal": "handicap_window",
                "points": 17,
                "max": 20,
                "note": "Your 14 handicap sits inside its 5-30 handicap window"
              },
              {
                "signal": "speed_window",
                "points": 13,
                "max": 15,
                "note": "Your 96 mph sits inside its 75-108 mph window"
              },
              {
                "signal": "price_tier",
                "points": 10,
                "max": 10,
                "note": "Its mid price tier matches your $300–600 budget"
              },
              {
                "signal": "recency",
                "points": 9,
                "max": 10,
                "note": "It is a 2025 model, and newer models score higher"
              }
            ],
            "rankedBecause": "Ranked first because your 14 handicap sits inside its 5-30 handicap window; it is a max forgiveness head, one of the types that suit you; and your 96 mph sits inside its 75-108 mph window."
          }
        ]
      }
    ],
    "modelUsage": {
      "llmUsed": false,
      "method": "deterministic_db_ranking",
      "rankingVersion": "r6-2026-10-10"
    }
  },
  "meta": {
    "version": "v1.1",
    "coverageTarget": {
      "fromYear": 2016,
      "throughYear": 2026
    },
    "requestId": "eq_sample"
  }
}

What it means

Ben Hogan Golf PTx MAX

no warnings

Every ranked product comes with the reasons behind its score.

Warnings such as discontinued or low confidence come back with the score, so you can act on them.

Code

Copy, paste, ship

Examples in TypeScript or plain cURL. Replace the key placeholder with your own.

typescript

const res = await fetch(
  "https://www.fitmyswing.com/api/v1/products/search?category=driver&brand=Callaway&limit=5",
  { headers: { "x-api-key": process.env.FITMYSWING_API_KEY! } },
)
const { data } = await res.json()

for (const product of data.products) {
  console.log(product.displayName, product.confidenceScore)
}

Needs an API key: get one free · Full reference