{
  "name": "Candles of USA — data dictionary",
  "version": 1,
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "Candles of USA (https://www.candlesofusa.com)",
  "endpoints": {
    "brands": "https://www.candlesofusa.com/api/brands.json",
    "states": "https://www.candlesofusa.com/api/states.json",
    "scents": "https://www.candlesofusa.com/api/scents.json"
  },
  "editorialPolicy": {
    "publishesRatings": false,
    "publishesReviews": false,
    "paidPlacement": false,
    "ordering": "alphabetical by company name, or numeric where a count applies",
    "note": "No rating, score or review field exists in this schema. Third-party marketplace figures, where present in a record body, are attributed inline to the platform that collected them."
  },
  "enums": {
    "waxTypes": [
      "soy",
      "coconut",
      "beeswax",
      "paraffin",
      "rapeseed",
      "blend"
    ],
    "certifications": [
      "phthalate-free",
      "paraben-free",
      "vegan",
      "cruelty-free",
      "lead-free-wick",
      "woman-owned",
      "veteran-owned",
      "family-owned",
      "b-corp"
    ],
    "imageSource": [
      "amazon-paapi",
      "pexels",
      "brand-permission",
      "own-photo",
      "placeholder"
    ]
  },
  "fields": {
    "brand": {
      "id": "Stable slug; also the URL segment under /brands/.",
      "name": "Trading name.",
      "state": "Two-letter USPS code for the state of manufacture.",
      "city": "City of manufacture.",
      "founded": "Founding year, or null where not published.",
      "website": "Official site.",
      "etsyUrl": "Marketplace storefront, or null.",
      "summary": "Factual description, 25 to 60 words. Contains no judgements.",
      "waxTypes": "Array from the waxTypes enum.",
      "priceMin": "Lowest published price in USD, or null.",
      "priceMax": "Highest published price in USD, or null.",
      "scentNotes": "Fragrance families across the catalogue.",
      "signatureScents": "Named products the company leads with.",
      "certifications": "Array from the certifications enum, as stated by the company.",
      "handPoured": "Boolean, as stated by the company.",
      "madeInUsa": "Boolean. False where a brand designs domestically but manufactures abroad.",
      "discontinuedScents": "Retired lines still generating search demand.",
      "sources": "Array of URLs supporting the record.",
      "lastVerified": "ISO date the record was last checked.",
      "verified": "True once a person has confirmed the record against its sources."
    },
    "product": {
      "name": "Product name.",
      "brand": "Brand id this product belongs to.",
      "scentNotes": "Fragrance notes.",
      "waxType": "Single value from the waxTypes enum.",
      "burnTimeHours": "Manufacturer-stated burn time, or null.",
      "weightOz": "Net weight in ounces, or null.",
      "price": "List price in USD, or null.",
      "vessel": "Container description.",
      "wickCount": "Number of wicks.",
      "discontinued": "Boolean."
    }
  }
}