canonical: https://jentic.com/apis/golfdata.co/golfdata # Golfdata GolfDataAPI The GolfData API serves a reviewed golf equipment catalog and dated retailer price observations from a single REST surface. It searches canonical products, returns one product with its enrichment provenance rows, reports current advertised prices per retailer, and reads daily price history. A compare operation returns dated observations with min, max, and median over 30 and 90 day windows, and offer-discovery operations find and verify admitted marketplace price sources. ## For AI agents Look up golf equipment products, read current and historical retailer prices, compare dated price observations, and discover verified marketplace price sources. ## Scope Does not sell equipment, process orders, or handle payments. Use for golf equipment catalog data and dated retailer price observations only. ## Capabilities - Look up canonical golf equipment products and one product's provenance rows - Search the reviewed product catalog - Retrieve current advertised prices per retailer for a product - Read daily price history and compare dated observations with min, max, and median - Discover and verify admitted marketplace price sources - Read catalog stats, the price ladder, and lookup costs ## Use cases ### Agent-Driven Price Lookups An AI agent helps a shopper find the best current price on a club without scraping retailer sites. It searches the catalog for the product, pulls the current advertised prices per retailer, and reports the lowest. Jentic exposes each GolfData operation with its input schema so the agent passes the product id or query correctly on the first call. Example prompt: Search the catalog for a driver, pull its current advertised prices per retailer, and report the lowest price ### Price History and Comparison A deals tool tracks how a product's price has moved before flagging a drop. The GolfData API reads daily price history per retailer and the compare operation returns dated observations with min, max, and median over 30 and 90 day windows. The tool decides whether today's price is actually a good one. Example prompt: Retrieve a product's 90 day price history and read the compare operation's min, max, and median to judge the current price ### Catalog and Source Discovery A catalog service keeps its product data and sources current without manual review. The GolfData API searches canonical products, returns one product with its enrichment provenance rows, and the offer-discovery operations find and verify admitted marketplace price sources. The service refreshes its listings straight from reviewed data. Example prompt: Fetch a product with its provenance rows, then discover and verify the admitted marketplace sources for it ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v1/products` | Search canonical products | | GET | `/v1/products/{id}` | Get one product with its provenance rows | | GET | `/v1/prices/current` | Read current advertised prices per retailer | | GET | `/v1/prices/history` | Read daily price history | | GET | `/v1/compare` | Compare dated observations with min, max, and median | | GET | `/v1/offers/discover` | Discover admitted marketplace sources | | GET | `/v1/meta` | Read catalog stats | ## Key resources - **Products** — Search canonical products and fetch one with its enrichment provenance rows - **Prices** — Read current advertised prices per retailer and daily price history - **Compare** — Return dated price observations with min, max, and median over 30 and 90 day windows - **Offers** — Discover and verify admitted marketplace price sources - **Meta and pricing** — Read catalog stats, the price ladder, lookup costs, and caller limits ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 48 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 74 / 100 - Developer Experience & Jentic Compatibility: 69 / 100 - AI-Readiness & Agent Experience: 25 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 57 / 100 - **View full report:** https://jentic.com/apis/golfdata.co/golfdata/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the GolfData API by hand means managing its x-api-key header, working out which endpoints accept keyless access, and tracking lookup costs and your caller lane. Through Jentic you install once, import GolfData from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** GolfData's lookups take the product id or query in the URL path or query string, so a rule bounds which operations your agent may call, such as product lookup and price history. The data operations are all reads, so you choose exactly which lookups the agent may run and nothing it calls changes data. - **Credential handling:** Your GolfData key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'look up golf prices' or 'compare price history', and Jentic returns the matching GolfData operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Ecommerce Data API** — Ecommerce Data API returns product and pricing data across marketplaces. - **Glade Amazon API** — Glade returns normalized Amazon product, offer, and estimate data. - **Amazon Scraper API** — Amazon Scraper API returns Amazon product and price data by scraping listings. ## FAQ ### What authentication does the GolfData API use? The GolfData API authenticates with an API key in the x-api-key header per its OpenAPI spec, and some read endpoints also work without a key at keyless limits. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never sits in your agent's prompt or logs. ### Can I get retailer prices with the GolfData API? Yes. The current-prices operation returns advertised prices per retailer for a product, the history operation returns daily snapshots, and the compare operation adds min, max, and median over 30 and 90 day windows. Your agent reads these directly rather than scraping retailer pages. ### What are the rate limits for the GolfData API? The GolfData limits operation returns your caller lane and remaining quota, including the keyless limits that apply without a key. Your agent reads its own ceiling from that operation rather than guessing a shared quota. ### Is there a GolfData MCP server? You do not need an MCP server to give your agent the GolfData API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls its operations. Operations are discovered on demand, so your agent's context stays lean instead of loading a full tool list up front. ### Can I limit what my agent is allowed to do with the GolfData API? Yes. Write a rule that allows only the product and price read operations, so the agent can look up products and prices but cannot submit contact or key-issuing operations, and every call it makes is logged. The data operations are all reads, so nothing the agent calls changes your own records. ### How do I look up golf prices with the GolfData API through Jentic? Search Jentic for 'look up current golf equipment prices', and it returns the GolfData current-prices operation with its input schema. Your agent passes the product and reads the advertised prices per retailer back. To run it on your own infrastructure, install Jentic One from its GitHub repo.