GolfData

Read-only golf-offer.v1 using Chip's admission, exact-variant and live redirect gate. Requires a known 27aDay marketplace deal/product source UUID; search_products returns canonical IDs, not these source IDs. Explicit variant_id null means no selectable variant. Returns verified_offer, check_price or unavailable; unknown currency/ratings stay unknown. No account actions, click attribution or purchase is performed. Deployment may be disabled (503).

{
  "type": "object",
  "properties": {
    "source_kind": {
      "type": "string",
      "enum": [
        "deal",
        "product"
      ]
    },
    "source_id": {
      "type": "string",
      "description": "Known marketplace source UUID, not canonical product UUID"
    },
    "canonical_product_id": {
      "type": "string",
      "description": "canonical product uuid, from search_products"
    },
    "variant_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Exact expected variant UUID or explicit null for nonvariant source"
    }
  },
  "required": [
    "source_kind",
    "source_id",
    "canonical_product_id",
    "variant_id"
  ],
  "additionalProperties": false
}

Discover admitted marketplace sources for a canonical product ID from search_products, then verify each returned offer through Chip's exact-source commerce gate. If variant_id is omitted or null on a variant-bearing product, returns selection_metadata_not_offer options; unsourced specs stay unknown. Supply the exact variant UUID to get offers. Two sources checked per page within a bounded 16-source live window, use next_offset; this is not exhaustive catalog coverage or a stable snapshot. Results retain golf-offer.v1, including check_price and unknown currency. No member actions or click attribution. Deployment may be disabled (503).

{
  "type": "object",
  "properties": {
    "canonical_product_id": {
      "type": "string",
      "description": "Canonical product UUID from search_products"
    },
    "variant_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "Exact variant UUID; null or omitted requests nonvariant offers or variant selection metadata"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 15,
      "description": "Use response next_offset within the bounded live window; default 0"
    }
  },
  "required": [
    "canonical_product_id"
  ],
  "additionalProperties": false
}

Search the canonical golf equipment catalog by brand, category, or free text. Call this first to resolve a product_id for the other tools. Categories: drivers, iron-sets, wedges, putters, fairway-woods, hybrids, balls, bags, shoes, gloves, apparel, headcovers, complete-sets, accessories, tech, rangefinders, grips.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "brand name, case insensitive"
    },
    "category": {
      "type": "string",
      "description": "one of the categories listed above"
    },
    "q": {
      "type": "string",
      "description": "free text matched against the product name"
    },
    "limit": {
      "type": "integer",
      "description": "1 to 100, default 25"
    }
  }
}

One product plus its enrichment_sources provenance rows. Every enriched field carries the source URL, confidence and checked_at it came from. Check enrichment_status before relying on specs: 'enriched' means model, release_year, msrp, description and specs are all sourced; 'partial' means some are missing.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "canonical product uuid, from search_products"
    }
  },
  "required": [
    "product_id"
  ]
}

Latest stored advertised prices for one canonical product, with stock observations and stored affiliate links. These are not exact-variant verified buyable offers; use get_verified_offer when a marketplace source ID is known.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "canonical product uuid, from search_products"
    }
  },
  "required": [
    "product_id"
  ]
}

Dated price observations per retailer, where available. Coverage and refresh times vary by source. These rows are asking prices, not proof that a discount or stock state is current.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "canonical product uuid, from search_products"
    },
    "days": {
      "type": "integer",
      "description": "1 to 365, default 30"
    }
  },
  "required": [
    "product_id"
  ]
}

Dated advertised retailer observations for one product plus min, max and median, and recorded 30 and 90 day lows. Coverage varies; these are not exact-variant verified purchase quotes.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "canonical product uuid, from search_products"
    }
  },
  "required": [
    "product_id"
  ]
}