Developer API

StrainCompass API

Access the cannabis strain catalog with THC/CBD, terpene profiles, effects, genetics, and more. Built for dispensaries, apps, and researchers.

Quick Start

# Fetch indica strains with THC above 20%

curl "https://straincompass.com/api/strains?type=indica&thcMin=20&limit=5"

Endpoints

GET/api/strainsBrowse and filter strains. Pages are bounded to 1–50; narrow filters to explore further. Invalid page, limit, type, sort, or THC values return HTTP 400. Limits depend on your tier. Generated default attributes are omitted; missing values remain null.

Parameters

type, effect, flavor, terpene, thcMin, thcMax, breeder, sort, page, limit, q

Example

fetch("https://straincompass.com/api/strains?type=indica&thcMin=20&limit=10")

Response

{
  "strains": [
    {
      "slug": "blue-dream",
      "name": "Blue Dream",
      "type": "HYBRID",
      "thcMax": 21,
      "cbdMax": 0.2,
      "effects": [{"name": "Relaxed", "intensity": 85}],
      "flavors": [{"name": "Berry"}],
      "terpenes": [{"name": "Myrcene", "level": "high"}]
    }
  ],
  "total": 15420,
  "page": 1,
  "totalPages": 50,
  "maxPage": 50,
  "paginationLimitReached": true
}

GET/api/strains/searchAutocomplete strain search

Parameters

q (2–120 characters)

Example

fetch("https://straincompass.com/api/strains/search?q=blue+dream")

Response

{
  "results": [
    {"slug": "blue-dream", "name": "Blue Dream", "type": "HYBRID", "thcMax": 21},
    {"slug": "blue-dream-cbd", "name": "Blue Dream CBD", "type": "CBD", "thcMax": 6}
  ]
}

API Pricing

Free

1,000/day per account requests

✓ 50 results per request
✓ Basic strain data
✓ Search endpoint
✓ Lab summary: test count + median THC
✓ Community support

Get a free key

Pro

$49/mo

10,000/day per account requests

✓ 100 results per request
✓ Full strain profiles
✓ Full lab distributions: THC, CBD, CBG, CBN, THCV, CBC + terpene % (16.5K flower tests, 3 labs)
✓ Terpene & effect data with provenance
✓ Genetics/lineage
✓ Priority support

Paid subscriptions are currently unavailable. Contact us about access.

Enterprise

$199/mo

Unlimited requests

✓ 500 results per request
✓ Everything in Pro
✓ Full dataset export (CSV/JSON) on request
✓ Dedicated support

Paid subscriptions are currently unavailable. Contact us about access.

Authentication

Requests without a key are capped at 1,000/day per IP and 24 results per request. A free key raises that to 1,000/day per account and 50 results. Send it in either header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://straincompass.com/api/strains?type=sativa"

Rate Limits

Daily keyed limits are shared across all keys on an account; keyless limits are per IP address. Separate per-minute protection also applies. Exceeded limits return HTTP 429 with a Retry-After header.

No key / day

Free / day

10K

Pro / day

∞

Enterprise