FindWeedNY

Search licensed New York State cannabis dispensaries (adult-use and medical). Free-text `query` is ranked and typo-tolerant (name, DBA, city, neighborhood, address, ZIP, license) and may include the site search operators (zip: city: county: neighborhood: brand: product: is:open|operating|delivery|micro|medical|verified|closed radius:N — quote multi-word values). Structured filters do the same thing explicitly. NOTE: `brand` filters against the PUBLIC availability preview (≤10 listed stores per brand); the result's `brandAvailability` block gives the true known count and, with `city`/`county`, how many stores there stock the brand even when none are listed — never conclude "nobody in X carries it" from an empty list. Sort by relevance (default with a query), distance (default when near is given), name, or recently_opened. Returns compact rows; each row has a citable `url`, Google rating/review count when known, `openNow` + `hoursToday` from posted hours (New York time), and a `closure` object (date, reason, temporary) when a shop has closed.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Ranked, typo-tolerant search over name/DBA/city/neighborhood/address/ZIP/license; accepts operators, e.g. \"housing works\", \"gotham zip:100\", \"brand:ayrloom is:open\""
    },
    "brand": {
      "type": "string",
      "description": "Only dispensaries stocking this brand (name or alias)"
    },
    "open_now": {
      "type": "boolean",
      "description": "Only dispensaries open right now by posted hours"
    },
    "verified": {
      "type": "boolean",
      "description": "Only owner-verified / claimed listings"
    },
    "city": {
      "type": "string",
      "description": "Exact city name, case-insensitive (e.g. \"Buffalo\")"
    },
    "county": {
      "type": "string",
      "description": "Exact county name, case-insensitive"
    },
    "neighborhood": {
      "type": "string",
      "description": "NYC neighborhood name or slug"
    },
    "zip": {
      "type": "string",
      "description": "5-digit ZIP code"
    },
    "near": {
      "type": "object",
      "description": "Filter/sort by distance from a point (results gain a `distance` in miles)",
      "properties": {
        "lat": {
          "type": "number",
          "description": "Latitude in decimal degrees"
        },
        "lng": {
          "type": "number",
          "description": "Longitude in decimal degrees (negative in New York)"
        },
        "radius_miles": {
          "type": "number",
          "description": "Search radius in miles, default 25"
        }
      },
      "required": [
        "lat",
        "lng"
      ]
    },
    "delivery": {
      "type": "boolean",
      "description": "Only dispensaries that offer delivery"
    },
    "medical": {
      "type": "boolean",
      "description": "Only dispensaries serving medical patients"
    },
    "microbusiness": {
      "type": "boolean",
      "description": "Only microbusiness licensees"
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "distance",
        "name",
        "recently_opened"
      ],
      "description": "Default: relevance with a query, distance with near, otherwise name"
    },
    "limit": {
      "type": "number",
      "description": "Max rows, default 10, cap 50"
    },
    "offset": {
      "type": "number",
      "description": "Rows to skip for paging: the result echoes `total` and `offset`, so request offset + limit for the next page"
    }
  }
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Matches before paging"
    },
    "offset": {
      "type": "number"
    },
    "dispensaries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "OCM license number (directory id)"
          },
          "name": {
            "type": "string"
          },
          "dba": {
            "type": "string",
            "description": "Legal entity name"
          },
          "licenseType": {
            "type": "string"
          },
          "tier": {
            "type": "string",
            "description": "open | coming-soon | delivery-only"
          },
          "status": {
            "type": "string"
          },
          "operationalStatus": {
            "type": "string",
            "description": "Active | Non-Operational | Unknown"
          },
          "isMedical": {
            "type": "boolean"
          },
          "isDeliveryOnly": {
            "type": "boolean"
          },
          "offersDelivery": {
            "type": "boolean"
          },
          "isMicrobusiness": {
            "type": "boolean"
          },
          "address": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "county": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "zipCode": {
            "type": "string"
          },
          "neighborhood": {
            "type": "string",
            "description": "NYC neighborhood, when applicable"
          },
          "latitude": {
            "type": "number"
          },
          "longitude": {
            "type": "number"
          },
          "phone": {
            "type": "string"
          },
          "website": {
            "type": "string"
          },
          "retailDateOpened": {
            "type": "string",
            "description": "YYYY-MM-DD the shop opened to the public"
          },
          "googleRating": {
            "type": "number"
          },
          "googleReviewCount": {
            "type": "number"
          },
          "openNow": {
            "type": "boolean",
            "description": "Open right now by posted hours (New York time); absent when hours are unknown"
          },
          "hoursToday": {
            "type": "string"
          },
          "closure": {
            "type": "object",
            "description": "Present only when the shop has closed",
            "properties": {
              "date": {
                "type": "string"
              },
              "announcedDate": {
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "temporary": {
                "type": "boolean"
              },
              "notes": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "distance": {
            "type": "number",
            "description": "Miles from `near`, when a near point was given"
          },
          "url": {
            "type": "string",
            "description": "findweedny.com page — cite this"
          }
        },
        "required": [
          "id",
          "name",
          "url"
        ],
        "additionalProperties": true
      }
    },
    "brandAvailability": {
      "type": "object",
      "description": "Present when a brand filter was applied. Never conclude \"nobody carries it\" from an empty list — read knownDispensaries / inCity.",
      "properties": {
        "brand": {
          "type": "string"
        },
        "tier": {
          "type": "string",
          "description": "preview (public: ≤10 stores listed) | full (signed-in /mcp/full)"
        },
        "listedDispensaries": {
          "type": "number"
        },
        "knownDispensaries": {
          "type": "number",
          "description": "How many stores actually stock the brand"
        },
        "inCity": {
          "type": "object",
          "properties": {
            "city": {
              "type": "string"
            },
            "count": {
              "type": "number"
            }
          },
          "additionalProperties": true
        },
        "inCounty": {
          "type": "object",
          "properties": {
            "county": {
              "type": "string"
            },
            "count": {
              "type": "number"
            }
          },
          "additionalProperties": true
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "brand",
        "tier",
        "listedDispensaries",
        "knownDispensaries"
      ],
      "additionalProperties": true
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Caveats about the filters applied"
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "total",
    "offset",
    "dispensaries"
  ],
  "additionalProperties": true
}

Full public record for one dispensary by OCM license number (e.g. "OCM-CAURD-23-000023"), verified alias, or legacy id. Includes hours, description, and license dates.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "License number, alias, or legacy id"
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "dispensary": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "OCM license number (directory id)"
        },
        "name": {
          "type": "string"
        },
        "dba": {
          "type": "string",
          "description": "Legal entity name"
        },
        "licenseType": {
          "type": "string"
        },
        "tier": {
          "type": "string",
          "description": "open | coming-soon | delivery-only"
        },
        "status": {
          "type": "string"
        },
        "operationalStatus": {
          "type": "string",
          "description": "Active | Non-Operational | Unknown"
        },
        "isMedical": {
          "type": "boolean"
        },
        "isDeliveryOnly": {
          "type": "boolean"
        },
        "offersDelivery": {
          "type": "boolean"
        },
        "isMicrobusiness": {
          "type": "boolean"
        },
        "address": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "zipCode": {
          "type": "string"
        },
        "neighborhood": {
          "type": "string",
          "description": "NYC neighborhood, when applicable"
        },
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        },
        "phone": {
          "type": "string"
        },
        "website": {
          "type": "string"
        },
        "retailDateOpened": {
          "type": "string",
          "description": "YYYY-MM-DD the shop opened to the public"
        },
        "googleRating": {
          "type": "number"
        },
        "googleReviewCount": {
          "type": "number"
        },
        "openNow": {
          "type": "boolean",
          "description": "Open right now by posted hours (New York time); absent when hours are unknown"
        },
        "hoursToday": {
          "type": "string"
        },
        "closure": {
          "type": "object",
          "description": "Present only when the shop has closed",
          "properties": {
            "date": {
              "type": "string"
            },
            "announcedDate": {
              "type": "string"
            },
            "reason": {
              "type": "string"
            },
            "temporary": {
              "type": "boolean"
            },
            "notes": {
              "type": "string"
            }
          },
          "additionalProperties": true
        },
        "distance": {
          "type": "number",
          "description": "Miles from `near`, when a near point was given"
        },
        "url": {
          "type": "string",
          "description": "findweedny.com page — cite this"
        },
        "geocodeAccuracy": {
          "type": "string"
        },
        "licenseIssueDate": {
          "type": "string"
        },
        "lastVerified": {
          "type": "string"
        },
        "hours": {
          "type": "object",
          "description": "Posted hours by weekday",
          "properties": {},
          "additionalProperties": true
        },
        "description": {
          "type": "string"
        },
        "claimed": {
          "type": "boolean"
        },
        "amenities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "licenseExpirationDate": {
          "type": "string"
        },
        "deliveryZipCodes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "id",
        "name",
        "url"
      ],
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "found"
  ],
  "additionalProperties": true
}

Look up ANY New York OCM cannabis license number — retail dispensary, microbusiness, cultivator, processor, distributor, registered organization — against the full OCM licensing record (3,000+ licenses), not just shops. Returns the license type, status, holder, dates, county, and for cultivators the grow method; links the matching dispensary listing and brand when we have them. A partial number, application number, or company name returns candidates in `similar`. Use it to answer "is this a real licensed NY business" and "who holds this license".

{
  "type": "object",
  "properties": {
    "license_number": {
      "type": "string",
      "description": "OCM license number (e.g. \"OCM-CAURD-23-000023\", \"OCM-PROC-24-000096\"), application number, or part of one; a company name also works"
    }
  },
  "required": [
    "license_number"
  ]
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "description": "A license record matched exactly"
    },
    "licensed": {
      "type": "boolean",
      "description": "found and the license status is Active"
    },
    "license": {
      "type": "object",
      "properties": {
        "licenseNumber": {
          "type": "string"
        },
        "applicationNumber": {
          "type": "string"
        },
        "licenseType": {
          "type": "string",
          "description": "e.g. Adult-Use Retail Dispensary License, Adult-Use Processor License, Adult-Use Cultivator License"
        },
        "licenseTypeCode": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "description": "OCM license status, e.g. Active"
        },
        "operationalStatus": {
          "type": "string"
        },
        "entityName": {
          "type": "string",
          "description": "Licensed legal entity"
        },
        "dba": {
          "type": "string"
        },
        "businessPurpose": {
          "type": "string"
        },
        "processorType": {
          "type": "string"
        },
        "tierType": {
          "type": "string",
          "description": "Cultivator / microbusiness canopy tier"
        },
        "seeCategory": {
          "type": "string",
          "description": "Social & economic equity category, when declared"
        },
        "cultivation": {
          "type": "object",
          "description": "Present for cultivator / microbusiness licenses",
          "properties": {
            "indoor": {
              "type": "boolean"
            },
            "outdoor": {
              "type": "boolean"
            },
            "mixedLight": {
              "type": "boolean"
            },
            "combination": {
              "type": "boolean"
            }
          },
          "additionalProperties": true
        },
        "county": {
          "type": "string"
        },
        "region": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "address": {
          "type": "string"
        },
        "zipCode": {
          "type": "string"
        },
        "website": {
          "type": "string"
        },
        "issuedDate": {
          "type": "string"
        },
        "effectiveDate": {
          "type": "string"
        },
        "expirationDate": {
          "type": "string"
        },
        "retailDateOpened": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "description": "findweedny.com license page"
        }
      },
      "required": [
        "licenseType",
        "status",
        "entityName",
        "url"
      ],
      "additionalProperties": true
    },
    "dispensary": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "OCM license number (directory id)"
        },
        "name": {
          "type": "string"
        },
        "dba": {
          "type": "string",
          "description": "Legal entity name"
        },
        "licenseType": {
          "type": "string"
        },
        "tier": {
          "type": "string",
          "description": "open | coming-soon | delivery-only"
        },
        "status": {
          "type": "string"
        },
        "operationalStatus": {
          "type": "string",
          "description": "Active | Non-Operational | Unknown"
        },
        "isMedical": {
          "type": "boolean"
        },
        "isDeliveryOnly": {
          "type": "boolean"
        },
        "offersDelivery": {
          "type": "boolean"
        },
        "isMicrobusiness": {
          "type": "boolean"
        },
        "address": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "zipCode": {
          "type": "string"
        },
        "neighborhood": {
          "type": "string",
          "description": "NYC neighborhood, when applicable"
        },
        "latitude": {
          "type": "number"
        },
        "longitude": {
          "type": "number"
        },
        "phone": {
          "type": "string"
        },
        "website": {
          "type": "string"
        },
        "retailDateOpened": {
          "type": "string",
          "description": "YYYY-MM-DD the shop opened to the public"
        },
        "googleRating": {
          "type": "number"
        },
        "googleReviewCount": {
          "type": "number"
        },
        "openNow": {
          "type": "boolean",
          "description": "Open right now by posted hours (New York time); absent when hours are unknown"
        },
        "hoursToday": {
          "type": "string"
        },
        "closure": {
          "type": "object",
          "description": "Present only when the shop has closed",
          "properties": {
            "date": {
              "type": "string"
            },
            "announcedDate": {
              "type": "string"
            },
            "reason": {
              "type": "string"
            },
            "temporary": {
              "type": "boolean"
            },
            "notes": {
              "type": "string"
            }
          },
          "additionalProperties": true
        },
        "distance": {
          "type": "number",
          "description": "Miles from `near`, when a near point was given"
        },
        "url": {
          "type": "string",
          "description": "findweedny.com page — cite this"
        }
      },
      "required": [
        "id",
        "name",
        "url"
      ],
      "additionalProperties": true,
      "description": "The directory listing, when the license is a retail dispensary we list"
    },
    "brand": {
      "type": "object",
      "description": "The brand catalog entry holding this license, when known",
      "properties": {
        "name": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "url": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "message": {
      "type": "string"
    },
    "similar": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "licenseNumber": {
            "type": "string"
          },
          "entityName": {
            "type": "string"
          },
          "dba": {
            "type": "string"
          },
          "licenseType": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "description": "Close matches when there is no exact one"
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "found",
    "licensed"
  ],
  "additionalProperties": true
}

Search cannabis brands sold in New York. Filter by name, product category (e.g. flower, vapes, edibles, pre-rolls), brand type (local / national / mso), New York origin, microbusiness licensees, grow method (indoor / outdoor / mixed-light / combination — from OCM cultivator licenses; "sun-grown" and "greenhouse" accepted as aliases), ownership certification (woman-owned, veteran-owned, bipoc-owned, social-equity…), tag, or parent brand (the house that owns it — e.g. which brands PharmaCann or 1 Off run in NY). Rows include growType, licenseType, certifications, tags and how many dispensaries stock the brand.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Substring match on brand name"
    },
    "category": {
      "type": "string",
      "description": "Product category, e.g. \"vapes\""
    },
    "type": {
      "type": "string",
      "enum": [
        "local",
        "national",
        "mso"
      ],
      "description": "Brand type: local (NY), national, or multi-state operator"
    },
    "ny_based": {
      "type": "boolean",
      "description": "Only brands headquartered / grown in New York"
    },
    "microbusiness": {
      "type": "boolean",
      "description": "Only brands holding a NY microbusiness license"
    },
    "grow_type": {
      "type": "string",
      "enum": [
        "indoor",
        "outdoor",
        "mixed-light",
        "combination",
        "sun-grown",
        "greenhouse"
      ],
      "description": "Cultivation method from OCM license data. sun-grown = outdoor; greenhouse = mixed-light or combination"
    },
    "certification": {
      "type": "string",
      "description": "Ownership/impact certification, e.g. \"woman-owned\", \"veteran-owned\", \"bipoc-owned\", \"social-equity\""
    },
    "tag": {
      "type": "string",
      "description": "Catalog tag, e.g. \"craft\", \"small-batch\", \"living-soil\", \"hudson-valley\""
    },
    "parent": {
      "type": "string",
      "description": "Only brands owned by this parent brand / house (slug or name), e.g. \"1-off\", \"PharmaCann\", \"GTI\""
    },
    "limit": {
      "type": "number",
      "description": "Max rows, default 10, cap 50"
    },
    "offset": {
      "type": "number",
      "description": "Rows to skip for paging: the result echoes `total` and `offset`, so request offset + limit for the next page"
    }
  }
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "brands": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "description": "local | national | mso"
          },
          "headquarters": {
            "type": "string"
          },
          "isNewYorkBased": {
            "type": "boolean"
          },
          "isMSO": {
            "type": "boolean"
          },
          "isMicrobusiness": {
            "type": "boolean"
          },
          "licenseType": {
            "type": "string"
          },
          "licenseNumber": {
            "type": "string"
          },
          "growType": {
            "type": "string",
            "description": "indoor | outdoor | mixed-light | combination (from OCM cultivator licenses)"
          },
          "productCategories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "certifications": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "founded": {
            "type": "number"
          },
          "parentBrand": {
            "type": "string",
            "description": "Slug of the house brand that owns this one"
          },
          "dispensaryCount": {
            "type": "number",
            "description": "Stores currently stocking the brand"
          },
          "shortDescription": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "url"
        ],
        "additionalProperties": true
      }
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "total",
    "offset",
    "brands"
  ],
  "additionalProperties": true
}

Full public record for one brand by slug or name, including which licensed NY dispensaries currently stock it (from crawled menu availability, preview tier), its parent / child brands, and FindWeedNY's own reviews of its products when there are any.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand slug or name"
    }
  },
  "required": [
    "brand"
  ]
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "brand": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "type": {
          "type": "string",
          "description": "local | national | mso"
        },
        "headquarters": {
          "type": "string"
        },
        "isNewYorkBased": {
          "type": "boolean"
        },
        "isMSO": {
          "type": "boolean"
        },
        "isMicrobusiness": {
          "type": "boolean"
        },
        "licenseType": {
          "type": "string"
        },
        "licenseNumber": {
          "type": "string"
        },
        "growType": {
          "type": "string",
          "description": "indoor | outdoor | mixed-light | combination (from OCM cultivator licenses)"
        },
        "productCategories": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "certifications": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "founded": {
          "type": "number"
        },
        "parentBrand": {
          "type": "string",
          "description": "Slug of the house brand that owns this one"
        },
        "dispensaryCount": {
          "type": "number",
          "description": "Stores currently stocking the brand"
        },
        "shortDescription": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "notableProducts": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "website": {
          "type": "string"
        },
        "parentBrandName": {
          "type": "string"
        },
        "parentBrandUrl": {
          "type": "string"
        },
        "childBrands": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "slug": {
                "type": "string"
              },
              "growType": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "reviews": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "product": {
                "type": "string"
              },
              "productType": {
                "type": "string"
              },
              "rating": {
                "type": "number"
              },
              "date": {
                "type": "string"
              },
              "thcPct": {
                "type": "number"
              },
              "totalTerpenesPct": {
                "type": "number"
              },
              "url": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "description": "FindWeedNY reviews of this brand"
        }
      },
      "required": [
        "id",
        "name",
        "slug",
        "url"
      ],
      "additionalProperties": true
    },
    "availability": {
      "type": "object",
      "properties": {
        "dispensaryCount": {
          "type": "number",
          "description": "Stores stocking the brand"
        },
        "listedDispensaries": {
          "type": "number"
        },
        "tier": {
          "type": "string",
          "description": "preview | full"
        },
        "crawledCategories": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "asOf": {
          "type": "string"
        },
        "availableAt": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name",
              "url"
            ],
            "additionalProperties": true
          }
        },
        "byCity": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "city": {
                "type": "string"
              },
              "count": {
                "type": "number"
              }
            },
            "additionalProperties": true
          }
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "dispensaryCount",
        "availableAt"
      ],
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "found"
  ],
  "additionalProperties": true
}

Current cannabis deal and promotion PREVIEWS (top deals per dispensary) for one dispensary or a city. The full deal feed requires a free account at findweedny.com.

{
  "type": "object",
  "properties": {
    "dispensary_id": {
      "type": "string",
      "description": "OCM license number"
    },
    "city": {
      "type": "string",
      "description": "City name (returns up to 5 dispensaries with deals)"
    },
    "limit": {
      "type": "number",
      "description": "Max deals per dispensary, default 6, cap 10"
    }
  }
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dispensary": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "name",
              "url"
            ],
            "additionalProperties": true
          },
          "deals": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "brand": {
                  "type": "string"
                },
                "category": {
                  "type": "string"
                },
                "price": {
                  "type": "number"
                },
                "originalPrice": {
                  "type": "number"
                },
                "savingsPct": {
                  "type": "number"
                },
                "thcPct": {
                  "type": "number"
                },
                "weight": {
                  "type": "string"
                },
                "strainType": {
                  "type": "string"
                },
                "productUrl": {
                  "type": "string"
                },
                "lastSeenAt": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          },
          "promotions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "promoType": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "startDate": {
                  "type": "string"
                },
                "endDate": {
                  "type": "string"
                },
                "lastSeenAt": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          },
          "totalDeals": {
            "type": "number"
          },
          "totalPromotions": {
            "type": "number"
          }
        },
        "required": [
          "dispensary",
          "deals",
          "promotions"
        ],
        "additionalProperties": true
      }
    },
    "note": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "additionalProperties": true
}

FindWeedNY's own independent, lab-anchored reviews of New York cannabis products (flower, vapes, concentrates, edibles). Every review has a 1–5 rating and, for cannabis products, the COA numbers: THC %, total terpenes %, top terpenes, plus a link to the certificate of analysis. Filter by brand, product type, strain, cultivation method, or minimum rating; sort by date, rating, or terpenes. Use this for "is brand X any good", "best-tested flower", or "most terpene-rich vape" questions. Rows carry an excerpt and a `url` to the full review.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Text match on title, product, brand, or strain"
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug"
    },
    "product_type": {
      "type": "string",
      "enum": [
        "flower",
        "vape",
        "concentrate",
        "edible",
        "accessory",
        "dispensary"
      ],
      "description": "Kind of product reviewed"
    },
    "strain": {
      "type": "string",
      "description": "Strain or type, e.g. \"hybrid\", \"sativa\", \"indica\", or a strain name"
    },
    "cultivation": {
      "type": "string",
      "enum": [
        "indoor",
        "outdoor",
        "mixed-light",
        "greenhouse"
      ],
      "description": "How the flower was grown, when the review records it"
    },
    "min_rating": {
      "type": "number",
      "description": "1–5"
    },
    "sort": {
      "type": "string",
      "enum": [
        "date",
        "rating",
        "terpenes",
        "thc"
      ],
      "description": "Default date (newest first)"
    },
    "limit": {
      "type": "number",
      "description": "Max rows, default 10, cap 50"
    },
    "offset": {
      "type": "number",
      "description": "Rows to skip for paging: the result echoes `total` and `offset`, so request offset + limit for the next page"
    }
  }
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "reviews": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "brand": {
            "type": "string"
          },
          "brandSlug": {
            "type": "string"
          },
          "brandUrl": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "productType": {
            "type": "string",
            "description": "flower | vape | concentrate | edible | accessory | dispensary"
          },
          "strain": {
            "type": "string"
          },
          "cultivation": {
            "type": "string"
          },
          "rating": {
            "type": "number",
            "description": "1–5, FindWeedNY's opinion"
          },
          "price": {
            "type": "string"
          },
          "date": {
            "type": "string"
          },
          "thcPct": {
            "type": "number",
            "description": "Total THC ≈ THCa×0.877 + Δ9, from the COA"
          },
          "totalTerpenesPct": {
            "type": "number"
          },
          "topTerpenes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "coaUrl": {
            "type": "string",
            "description": "Certificate of analysis"
          },
          "excerpt": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "title",
          "rating",
          "url"
        ],
        "additionalProperties": true
      }
    },
    "note": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "total",
    "offset",
    "reviews"
  ],
  "additionalProperties": true
}

One review by slug (from search_reviews) with the full lab panel: every cannabinoid and terpene measured, batch number, price paid, COA link, and the excerpt. Full review text stays on the linked page.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Review slug, e.g. \"1slice-superboof-flower\""
    }
  },
  "required": [
    "slug"
  ]
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "review": {
      "type": "object",
      "properties": {
        "slug": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "brand": {
          "type": "string"
        },
        "brandSlug": {
          "type": "string"
        },
        "brandUrl": {
          "type": "string"
        },
        "product": {
          "type": "string"
        },
        "productType": {
          "type": "string",
          "description": "flower | vape | concentrate | edible | accessory | dispensary"
        },
        "strain": {
          "type": "string"
        },
        "cultivation": {
          "type": "string"
        },
        "rating": {
          "type": "number",
          "description": "1–5, FindWeedNY's opinion"
        },
        "price": {
          "type": "string"
        },
        "date": {
          "type": "string"
        },
        "thcPct": {
          "type": "number",
          "description": "Total THC ≈ THCa×0.877 + Δ9, from the COA"
        },
        "totalTerpenesPct": {
          "type": "number"
        },
        "topTerpenes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "coaUrl": {
          "type": "string",
          "description": "Certificate of analysis"
        },
        "excerpt": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "batch": {
          "type": "string"
        },
        "cannabinoids": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "pct": {
                "type": "number"
              }
            },
            "required": [
              "name",
              "pct"
            ],
            "additionalProperties": true
          }
        },
        "terpenes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "pct": {
                "type": "number"
              }
            },
            "required": [
              "name",
              "pct"
            ],
            "additionalProperties": true
          }
        },
        "productUrl": {
          "type": "string"
        }
      },
      "required": [
        "slug",
        "title",
        "rating",
        "url"
      ],
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "found"
  ],
  "additionalProperties": true
}

Summary statistics for the New York licensed cannabis market: dispensary totals, counts by license type and tier, microbusiness / delivery / non-operational counts, top cities, dispensaries opened and closed in the last 90 days, and brand totals by type and grow method.

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Licensed dispensaries in the directory"
    },
    "medicalServing": {
      "type": "number"
    },
    "microbusinesses": {
      "type": "number"
    },
    "offeringDelivery": {
      "type": "number"
    },
    "deliveryOnly": {
      "type": "number"
    },
    "nonOperational": {
      "type": "number"
    },
    "byLicenseType": {
      "type": "object",
      "description": "license type → count",
      "properties": {},
      "additionalProperties": true
    },
    "byTier": {
      "type": "object",
      "description": "open | coming-soon | delivery-only → count",
      "properties": {},
      "additionalProperties": true
    },
    "topCities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "city": {
            "type": "string"
          },
          "count": {
            "type": "number"
          }
        },
        "additionalProperties": true
      }
    },
    "recentlyOpened": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "opened": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "description": "Opened in the last 90 days"
    },
    "recentlyClosed": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "closed": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "temporary": {
            "type": "boolean"
          },
          "url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "description": "Closed in the last 90 days"
    },
    "brands": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number"
        },
        "byType": {
          "type": "object",
          "properties": {},
          "additionalProperties": true
        },
        "byGrowType": {
          "type": "object",
          "properties": {},
          "additionalProperties": true
        },
        "microbusinesses": {
          "type": "number"
        }
      },
      "additionalProperties": true
    },
    "openDataHub": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "total"
  ],
  "additionalProperties": true
}

Statewide New York cannabis market aggregates, crawled from Metrc’s public Cannabis Market Landscape dashboard — the seed-to-sale system every licensee reports into. Use it for market-size and trend questions (how much does NY sell a month, which regions and product categories, how many licenses exist and how fast are they being issued, what share of lab tests pass). Returns a `summary` of the four headline numbers plus a `metrics` array: monthly retail sales, cumulative sales, units sold, transaction count, basket size, average price per unit, lab test volume and pass rate, retail sales by region and by product category, active licenses by type and by region, monthly new licenses and cumulative license growth. Narrow it with `section` or `metric`; `metricsAvailable` always lists everything in the snapshot. This is dashboard-level aggregate data, not transaction-level Metrc records, and license counts may differ from NY OCM totals. For dispensary-by-dispensary counts use get_market_stats instead.

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "enum": [
        "market_overview",
        "license_activity"
      ],
      "description": "Only metrics from this dashboard tab."
    },
    "metric": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only these metric names (see metricsAvailable), e.g. [\"retail_sales_by_region\"]."
    }
  },
  "additionalProperties": true
}

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "marketLandscape": {
      "type": "object",
      "description": "Aggregate values crawled from Metrc’s public New York Cannabis Market Landscape dashboard",
      "properties": {
        "meta": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string"
            },
            "sourceUrl": {
              "type": "string"
            },
            "fetchedAt": {
              "type": "string",
              "description": "When this snapshot was taken. The dashboard itself keeps no archive."
            },
            "dateRange": {
              "type": "string",
              "description": "The dashboard filter this snapshot was read under; YTD is the default."
            },
            "scope": {
              "type": "string"
            }
          },
          "additionalProperties": true
        },
        "summary": {
          "type": "object",
          "properties": {
            "activeLicenses": {
              "type": "number"
            },
            "newLicensesYearToDate": {
              "type": "number"
            },
            "totalRetailSales": {
              "type": "number",
              "description": "Year-to-date retail sales in USD, at full precision."
            },
            "overallAverageTestPassRate": {
              "type": "number",
              "description": "Percent, 0-100."
            }
          },
          "additionalProperties": true,
          "description": "The four headline numbers, so simple questions do not need the metrics array."
        },
        "metrics": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "section": {
                "type": "string",
                "description": "market_overview | license_activity — which dashboard tab published it"
              },
              "metric": {
                "type": "string"
              },
              "title": {
                "type": "string",
                "description": "The chart title as it appears on the dashboard"
              },
              "unit": {
                "type": "string",
                "description": "USD | licenses | units | transactions | tests | percent | USD per unit | USD per transaction"
              },
              "dimension": {
                "type": "string",
                "description": "What each point’s category is: region | product_category | license_type. Absent on scalars and monthly series."
              },
              "derivedFrom": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Present only when FindWeedNY computed this metric by dividing the listed series, because the dashboard did not return its own element that day."
              },
              "points": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "period": {
                      "type": "string",
                      "description": "ISO month start (YYYY-MM-01). Present on monthly series only."
                    },
                    "category": {
                      "type": "string",
                      "description": "The breakdown member. Present on breakdowns only — see dimension."
                    },
                    "value": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "value"
                  ],
                  "additionalProperties": true
                }
              }
            },
            "required": [
              "section",
              "metric",
              "title",
              "unit",
              "points"
            ],
            "additionalProperties": true
          }
        },
        "metricsAvailable": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Every metric in the snapshot, including any filtered out of this response. Call again with `metric` to fetch one."
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": true
    },
    "source": {
      "type": "string",
      "description": "Attribution line — CC BY 4.0, cite the row url"
    },
    "dataUpdated": {
      "type": "string",
      "description": "ISO timestamp of the feed this result came from: dispensary directory (OCM refresh), deals export, brand-availability export, or review index"
    }
  },
  "required": [
    "found"
  ],
  "additionalProperties": true
}