# GolfDataAPI API

**Canonical:** https://apis.io/apis/golfdata-co/golfdataapi-api/  
**Provider:** GolfData — https://apis.io/providers/golfdata-co/  
**Base URL:** https://golfdata.co  
**Documentation:** https://golfdata.co/docs/

GolfDataAPI API is one of 2 APIs that [GolfData](https://apis.io/providers/golfdata-co/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 3 JSON Schemas.

Golf equipment catalog and dated retailer price observations. $0.005 per lookup.

## Operations (29)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/catalog` | Reviewed factual records independently eligible for agent API use; no affiliate enrollment required. |
| GET | `/catalog` | Reviewed factual catalog for public web display. |
| GET | `/v1/meta` | Catalog stats: counts by category, enrichment coverage, snapshot count, freshness. |
| GET | `/v1/pricing` | Price ladder, lookup costs and machine URLs. |
| GET | `/v1/spotlight` | Twelve enriched products with 90 day daily-low series, current low, 30 and 90 day lows. Cached one hour. |
| GET | `/v1/limits` | Caller's lane and remaining quota, or the keyless limits without a key. |
| GET | `/v1/products` | Search canonical products. |
| GET | `/v1/products/{id}` | One product plus its enrichment_sources provenance rows. |
| GET | `/p/{slug}/{id}` | Public HTML product page with dated price observations and available history. |
| GET | `/p/{id}` | Redirect to the canonical public HTML product page. |
| GET | `/compare/{slug}/{idA}/{idB}` | Public HTML price comparison page for two canonical products. |
| GET | `/drops` | Public HTML page of the biggest current price drops, grouped by category. |
| GET | `/drops/{category}` | Public HTML page of the biggest price drops in one category. |
| GET | `/partners` | Public HTML partner kit page with free key, badge and Price Index terms for publishers and creators. |
| GET | `/brands` | Public HTML index of major golf brands. |
| GET | `/brands/{brand}` | Public HTML hub of observed prices for one major brand. |
| GET | `/retailers` | Public HTML index of retailers with fresh priced products. |
| GET | `/retailers/{retailer}` | Public HTML hub of products a retailer prices lowest. |
| GET | `/badge/{productId}.svg` | Embeddable SVG price badge for one product. |
| GET | `/v1/prices/current` | Latest stored advertised prices per retailer with optional machine checked verdicts. |
| GET | `/v1/prices/history` | Daily price snapshots per retailer, days up to 365. |
| GET | `/v1/compare` | Dated price observations plus min, max, median, recorded 30 and 90 day lows, and optional machine checked verdicts. |
| GET | `/v1/offers/discover` | Discover admitted marketplace sources and verify each through the Chip gate. |
| GET | `/v1/offers/verified` | Verify one known marketplace source (golf-offer.v1). |
| POST | `/v1/keys` | Issue a free key to an email, once per email. Body {email}, JSON or form-encoded. 3 per minute per IP. |
| GET | `/reports/2026-08` | Paid August 2026 Market Movement Report as HTML. Stripe Payment Link redirects here with session_id; the session is the access token. |
| GET | `/v1/keys/claim` | Claim the paid key for a completed Stripe Checkout Session, once. Stripe Payment Links redirect here with session_id. 3 per minute per IP. |
| POST | `/v1/contact` | Submit a retailer or brand contact request. Body {company,email,feed_url,message,reason}, JSON or form-encoded. |
| POST | `/mcp` | MCP streamable HTTP, JSON-RPC 2.0. Same reads as tools. |

## Machine-readable artifacts (4)

- **OpenAPI** — https://artifacts.apis.io/golfdata-co/openapi/_original/golfdata-co-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/golfdata-co/json-schema/golfdata-co-offer-discovery-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/golfdata-co/json-schema/golfdata-co-verified-offer-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/golfdata-co/json-schema/golfdata-co-offer-verdict-schema.json

## Other GolfData APIs (1)

- [GolfData API](https://apis.io/apis/golfdata-co/golfdata-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/golfdata-co/golfdataapi-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/golfdata-co/.