Products Endpoint

Search for cannabis products across thousands of dispensaries. Filter by location, category, brand, potency, price, and more.

Request

GET https://api.cannmenus.com/v2/products

Core Parameters

Location Parameters

Narrow results by geographic area:

Product Filters

Potency Filters

Filter by exact cannabinoid content:

Price Filter

Menu Type

Inventory & Source Filters

Terpene Profiles

Terpene data is opt-in. Add include_terpenes=true to a /v2/products or /v1/products request to get each listing's terpene profile.

Terpene Response Fields

Reading a profile:

• Keys are terpene names as published on the dispensary's menu, such as Myrcene, Limonene, Beta-Caryophyllene, Alpha-Pinene, and Linalool. Names aren't fully standardized across sources (both Bisabolol and AlphaBisabolol appear, for example), so normalize names before you aggregate across products.
• A profile lists only the terpenes with a reported value for that listing. A terpene that's missing from the object has no value in the response; don't treat it as zero.
• Profiles belong to listings, not products. The same SKU at two stores can have slightly different profiles, and one store's listing can have a profile while another's has none.

Coverage

Most listings don't have a terpene profile, so many rows, sometimes a whole page, come back with terpene_profile: null even when the request is correct. Profiles come from lab results that dispensaries publish on their online menus. Coverage depends on menu provider, state, and category, and it changes as dispensaries update their menus.

Menu provider. Profiles currently come only from listings whose menu_provider is Dutchie or IHeartJane. Listings from other providers, including Weedmaps, have no terpene data. In some states, such as California and Colorado, even Dutchie listings rarely carry profiles.

State. Based on a sample of in-stock listings taken in October 2026:

Even in the higher-coverage states, many listings have no profile. States that aren't listed had too few listings in the sample to rate.

Category. Flower and concentrates have profiles most often, followed by vapes and pre-rolls. Tinctures, topicals, and edibles rarely have one, and Other (accessories) almost never.

Getting More Terpene Data

• Filter to the providers that publish terpenes. Add menu_provider=Dutchie or menu_provider=IHeartJane. menu_provider takes one value per request and is case-sensitive: menu_provider=dutchie returns no results.
• Request the categories that carry profiles: Flower, Concentrate, Vape, and Pre-roll.
• Don't judge coverage from one page. Results aren't ordered by data completeness, so one page can be all null even in a higher-coverage state. Check several pages, or filter by provider, before you conclude a market has no terpene data.
• Add include_terpene_fallback=true. Listings without a profile of their own can take one from another listing of the same product in the same state.
• Expect new listings to lag. Terpene profiles are refreshed on their own schedule, less often than menu listings, and there is no guaranteed refresh interval. A product that just appeared on a menu can show null until the next terpene refresh.

Terpene profiles aren't available from:

• The Meta SKU endpoints, /v1/products/meta and /v2/products/meta.

Terpene Examples

Flower in Maryland with terpene profiles:

curl "https://api.cannmenus.com/v2/products?states=Maryland&category=Flower&per_page=20&include_terpenes=true" \
  -H "X-Token: YOUR_API_TOKEN"

Only Dutchie listings, which carry most terpene data:

curl "https://api.cannmenus.com/v2/products?states=Maryland&category=Flower&menu_provider=Dutchie&per_page=20&include_terpenes=true" \
  -H "X-Token: YOUR_API_TOKEN"

Only IHeartJane listings, in Nevada:

curl "https://api.cannmenus.com/v2/products?states=Nevada&category=Flower&menu_provider=IHeartJane&per_page=20&include_terpenes=true" \
  -H "X-Token: YOUR_API_TOKEN"

Both flags, for pre-rolls in New Jersey:

curl "https://api.cannmenus.com/v2/products?states=New%20Jersey&category=Pre-roll&per_page=20&include_terpenes=true&include_terpene_fallback=true" \
  -H "X-Token: YOUR_API_TOKEN"

The same Dutchie request on V1:

curl "https://api.cannmenus.com/v1/products?states=Maryland&category=Flower&menu_provider=Dutchie&per_page=20&include_terpenes=true" \
  -H "X-Token: YOUR_API_TOKEN"

A listing from the Dutchie request (abridged):

{
  "retailer_id": "3511",
  "sku": "00fkdAaOGVYObviGUYD5ffRp",
  "products": [
    {
      "brand_name": "Curio Wellness",
      "product_name": "Hot Wing Baby Buds",
      "category": "Flower",
      "menu_provider": "Dutchie",
      "terpene_profile": {
        "Limonene": 0.0094,
        "Myrcene": 0.0052,
        "Beta-Caryophyllene": 0.0033,
        "Linalool": 0.0024,
        "Beta-Pinene": 0.0012
      },
      "terpene_source": "exact",
      "terpene_source_product_id": null
    }
  ]
}

Print the top three terpenes, as percentages, for each listing that has a profile:

import requests

resp = requests.get(
    "https://api.cannmenus.com/v2/products",
    headers={"X-Token": "YOUR_API_TOKEN"},
    params={
        "states": "Maryland",
        "category": "Flower",
        "menu_provider": "Dutchie",
        "per_page": 20,
        "include_terpenes": "true",
    },
)
resp.raise_for_status()

for entry in resp.json()["data"]:
    for listing in entry["products"]:
        profile = listing["terpene_profile"]
        if not profile:
            continue  # no measured profile for this listing
        top = sorted(profile.items(), key=lambda kv: kv[1], reverse=True)[:3]
        print(
            listing["product_name"],
            listing["terpene_source"],
            ", ".join(f"{name} {value * 100:.2f}%" for name, value in top),
        )

Pagination

Example Requests

Basic Search

Search for flower in California:

curl "https://api.cannmenus.com/v2/products?states=California&category=Flower&page=1" \
  -H "X-Token: YOUR_API_TOKEN"

Location-Based Search

Find edibles within 5 miles of Denver:

curl "https://api.cannmenus.com/v2/products?states=Colorado&category=Edible&lat=39.7392&lng=-104.9903&distance=5&page=1" \
  -H "X-Token: YOUR_API_TOKEN"

Search by Brand Name

Find Stiiizy products in California:

curl "https://api.cannmenus.com/v2/products?states=California&brand_name=Stiiizy&page=1" \
  -H "X-Token: YOUR_API_TOKEN"

Text Search

Search for "blue dream" in product and brand names:

curl "https://api.cannmenus.com/v2/products?states=Washington&q=blue%20dream&page=1" \
  -H "X-Token: YOUR_API_TOKEN"

Multiple Filters

Live resin vapes from a specific brand in Nevada:

curl "https://api.cannmenus.com/v2/products?states=Nevada&category=Vape&brand_name=Stiiizy&tags=Live%20Resin&page=1" \
  -H "X-Token: YOUR_API_TOKEN"

Response

The terpene fields in this example are filled because the request set include_terpenes=true; without it they're null.

{
  "data": [
    {
      "retailer_id": "10600",
      "sku": "07A0Sbb8OieeaR8rIW6MVHRw",
      "products": [
        {
          "cann_sku_id": "07A0Sbb8OieeaR8rIW6MVHRw",
          "brand_name": "Cookies",
          "brand_id": 1042,
          "url": "https://dutchie.com/store/example/product/gary-payton",
          "image_url": "https://images.dutchie.com/products/gary-payton.jpg",
          "raw_product_name": "Cookies - Gary Payton 3.5g",
          "product_name": "Gary Payton",
          "raw_weight_string": "3.5g",
          "display_weight": "3.5g",
          "raw_product_category": "Flower",
          "category": "Flower",
          "raw_subcategory": "Flower",
          "subcategory": null,
          "product_tags": ["Hybrid", "Indoor"],
          "percentage_thc": 28.5,
          "percentage_cbd": 0.1,
          "cbd_thc_ratio": "20:1",
          "mg_thc": null,
          "mg_cbd": null,
          "quantity_per_package": 1,
          "medical": false,
          "recreational": true,
          "latest_price": 55.00,
          "original_price": 65.00,
          "menu_provider": "Dutchie",
          "is_below_threshold": false,
          "is_stock_image": false,
          "terpene_profile": {
            "Myrcene": 0.0089,
            "Limonene": 0.0072,
            "Beta-Caryophyllene": 0.0045
          },
          "terpene_source": "exact",
          "terpene_source_product_id": null
        }
      ]
    }
  ],
  "pagination": {
    "total_records": 1250,
    "current_page": 1,
    "total_pages": 63,
    "next_page": 2,
    "prev_page": null
  }
}

Response Fields

Data Freshness & History

Product data is refreshed from dispensary menus periodically throughout the day; there is no guaranteed refresh interval. Each response is a snapshot of the most recent menu data. The REST API does not return past prices or past availability.

For history, use the MCP server (tool availability depends on your plan):

• get_product_events: stock and price events, such as stockouts, restocks, and price changes
• deal_history: past deals and promotions (see Deals & Promotions)

Best Practices

Use Location Filters for Performance

Queries with lat/lng are faster and return more relevant results:

# Faster - location-scoped
?states=California&lat=34.0522&lng=-118.2437&distance=10

# Slower - state-wide scan
?states=California

Use IDs Instead of Text Search

Use brands and retailers with numeric IDs instead of brand_name for significantly faster queries:

# Faster - ID-based
?states=California&brands=789

# Slower - text search
?states=California&brand_name=Stiiizy

Paginate Through All Results

Don't assume all results fit on one page. Always check pagination.next_page:

all_products = []
page = 1

while True:
    response = requests.get(
        f"{API_URL}/products",
        headers=headers,
        params={"states": "California", "category": "Flower", "page": page, "per_page": 200}
    )
    data = response.json()
    all_products.extend(data["data"])

    if data["pagination"]["next_page"] is None:
        break
    page += 1

Cache Retailer IDs

If you frequently query products from the same dispensaries, cache their retailer IDs and use the retailers parameter for faster lookups.

Use per_page=200 for Bulk Pulls

The default is 20 results per page. Set per_page=200 to reduce total API calls by 10x:

?states=Colorado&per_page=200&page=1

Always Filter Medical vs Recreational

For states with adult-use/recreational markets (CA, CO, IL, MI, MA, NV, AZ, NJ, etc.), always set recreational=true to avoid double-counting from shared med/rec inventory systems. For medical-only states (FL, PA, OK), use medical=true.

# Recreational state
?states=California&recreational=true

# Medical-only state
?states=Florida&medical=true

V1 Legacy Format

V1 uses repeated query parameters instead of comma-separated strings:

GET https://api.cannmenus.com/v1/products

V1 returns the same response format and supports per_page and terpene profiles. It differs from V2 in three ways:

• List parameters are repeated instead of comma-separated (table above).
• states is required unless lat, lng, and distance are all provided.
• V1 adds inclusive range filters that V2 does not currently support:

Meta SKU Endpoint

The meta endpoint tags each listing with its Meta SKU (a UUID that identifies the same product across different retailers) instead of grouping by retailer SKU. Results are sorted by meta_sku, so listings of the same product at different retailers sit next to each other. This is useful for cross-retailer product matching and deduplication.

GET https://api.cannmenus.com/v2/products/meta

Parameters

The meta endpoint accepts a subset of the main products parameters:

• Location: lat, lng, distance
• states (required)
• IDs: retailers, brands
• Text: brand_name, product_name
• Product: display_weight, category (single value), subcategory, tags, quantity_per_package
• Potency: percentage_thc, percentage_cbd, mg_thc, mg_cbd
• Price: latest_price
• Source and menu type: menu_provider, recreational, medical
• page

It does not accept per_page (results are fixed at 20 per page), q, skus, or the include_* options. It adds:

Response

The response uses the same pagination format. Each data entry is one listing: its retailer_id, its meta_sku, and a products array holding that listing. On /v2/products/meta, listings that share a meta_sku can span more than one page:

{
  "data": [
    {
      "retailer_id": "10600",
      "meta_sku": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "products": [
        {
          "product_name": "Blue Dream",
          "brand_name": "Cookies",
          "category": "Flower",
          "latest_price": 45.00
        }
      ]
    }
  ],
  "pagination": {
    "total_records": 523,
    "current_page": 1,
    "total_pages": 27,
    "next_page": 2,
    "prev_page": null
  }
}

Example Request

curl "https://api.cannmenus.com/v2/products/meta?states=California&category=Flower&page=1" \
  -H "X-Token: YOUR_API_KEY"

The V1 meta endpoint (/v1/products/meta) accepts the same parameters, plus per_page (default 20, max 200), include_below_threshold, and include_all_menu_providers.