Verified product truth for the agents you build

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "category": {
      "description": "A category slug such as skincare-actives or mattresses. Prefixes and plain names resolve.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "topic": {
      "description": "Free text, resolved to the closest served category when no slug matches.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "claim": {
      "description": "The claim text to grade, 1 to 6000 characters.",
      "type": "string",
      "minLength": 1,
      "maxLength": 6000
    },
    "check_id": {
      "description": "Poll a check you started: the check_id from a pending answer.",
      "type": "string",
      "pattern": "^chk_[0-9a-f]{32}$"
    },
    "url": {
      "description": "A product page URL (https). Answers not_covered today: the spec index is unbuilt.",
      "type": "string",
      "maxLength": 2048
    },
    "sku": {
      "description": "A product SKU. Answers not_covered today: the spec index is unbuilt.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "category": {
      "description": "Optional category slug, a hint only. An unknown category is dropped, never a reason to skip grading.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "description": "The merchant, by domain (nike.com) or name (Nike). Required today.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "sku": {
      "description": "A product SKU. Alone, it answers unresolved today.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "limit": {
      "description": "How many offers to return, 1 to 10 (default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  }
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "One merchant, by domain (nike.com) or full name (Nike). Required — this tool never answers for a merchant you did not name."
    },
    "promo_code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "The exact promo code to check, as the shopper has it. Case and surrounding spaces are ignored."
    }
  },
  "required": [
    "merchant",
    "promo_code"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "One merchant, by domain (nike.com) or full name (Nike). Required — this tool never answers for a merchant you did not name."
    },
    "limit": {
      "default": 10,
      "description": "How many verified offers to return, 1 to 20. Defaults to 10. This bounds one merchant, not a merchant walk.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "merchant"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "One merchant, by domain (nike.com) or full name (Nike). Required — this tool never answers for a merchant you did not name."
    }
  },
  "required": [
    "merchant"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "merchant": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "The merchant the code was used at, as domain or name — the same identifier you looked it up with."
    },
    "code_ref": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "The `code_ref` SimplyCodes returned with the offer. Not the code string itself."
    },
    "outcome": {
      "type": "string",
      "enum": [
        "worked",
        "failed",
        "expired",
        "not_applicable"
      ],
      "description": "What happened at checkout. worked — the code applied and discounted the order. failed — the code was rejected. expired — the merchant said the code has expired. not_applicable — the shopper never attempted it (wrong cart, changed their mind)."
    },
    "issue": {
      "description": "Why it failed. Send this only with outcome failed; it is the folded code-feedback vote.",
      "type": "string",
      "enum": [
        "expired",
        "minimum_not_met",
        "excluded_items",
        "invalid",
        "other"
      ]
    },
    "order_value": {
      "description": "Order total in the store's currency, if the shopper shared it. Optional, never required.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    },
    "discount_value": {
      "description": "How much the code took off, if known. Optional.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    },
    "notes": {
      "description": "One short human note, 500 characters max. No personal data.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "merchant",
    "code_ref",
    "outcome"
  ]
}