Equipment graph
Brands, models, release years, specs, variants and aliases, each with one canonical product ID.
Golf Equipment API · partner beta
Club data that fits.
The catalog and fit scoring behind FitMySwing, for golf apps, retailers, fitters and AI products. Search, compare, score the fit and rank the picks, with a confidence level on every record.
Canonical IDsFit warningsConfidence on every record
POST /api/v1/recommendationssample response
Request
{
"golferProfile": {
"handicap": 14,
"swingSpeed": 96,
"miss": "Slice",
"trajectory": "Mid",
"budget": "$300–600"
},
"categories": [
"driver"
],
"limit": 1
}Response
{
"data": {
"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."
}
]
}
]
}
}totalScore
64
warning
none
confidence
verified
Runs FitMySwing. Every fitting uses it.
Partner beta. Free API keys, with rate limits and usage counts.
Honest coverage. Confidence on every record, not guesses.
What you get
More than a product list
Four layers you’d otherwise build yourself, behind one key.
Fit scoring
Score any product for a golfer, or get ranked picks with the reasons behind each one.
Comparisons
Heads and shafts side by side: specs, price, status, fit and the gap between them.
Provenance
Confidence, verification dates and sources on every record, so you know what to trust.
Samples
Open the playground See a sample request and response
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
{
"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.
Built for
Teams that need real golf data
- Fitting appsClub recommendations without building the data yourself.
- Golf retailersBetter search, side-by-side comparisons and club finders.
- Fitters and studiosInternal tools and pre-fitting research.
- PublishersStructured gear pages and buying widgets.
- Golf tech startupsSkip months of equipment data work.
From data to a pick
The fit layer is the hard part
Product data is the easy bit. Turning a golfer’s numbers into ranked, explained picks is what the API does for you.
- 01Product data
- 02Normalized specs
- 03Golfer profile
- 04Fit scoring
- 05Ranked picks
- 06Your app
Coverage
Clear about what’s covered
Coverage and confidence are part of every response. A seeded record stays marked as seeded until independent sources confirm it.
Categories
Irons, drivers, putters, balls, driver shafts, fairway woods, wedges, hybrids, iron shafts, grips
Model years
2016–2026
Brands
50 brands, from the majors to direct-to-consumer
Every response
Canonical IDs and confidence
Access
See what’s included Free during the beta.
Every sandbox account includes 2,500 data calls and 100 fit credits a month, shared by all its keys. No card needed.
FitMySwing proves it works. Build on it.
The sandbox is free. No card needed.