
StrainCompass API
Access the cannabis strain catalog with THC/CBD, terpene profiles, effects, genetics, and more. Built for dispensaries, apps, and researchers.
Discuss an API integrationTell us what you're building and the data you need.
Quick Start
# Fetch indica strains with THC above 20%
curl "https://straincompass.com/api/strains?type=indica&thcMin=20&limit=5"
Endpoints
Server-side integration required for keyed requests. API keys must never be embedded in browser code. Call the API from your backend or a serverless function. The API does not currently authorize cross-origin browser requests.
Download the OpenAPI 3.0 schemaStrain responses include a separate illustrationUrl and illustrationKind for unique generated botanical artwork. These illustrations show an imagined appearance. The source imageUrl remains separate and may be null. Missing source potency remains null in the API; the website's labelled population references are context, not cultivar measurements.
/api/strainsBrowse and filter strains. Pages are bounded to 1–50. Sort values: popular, name, thc-high, thc-low, rating, newest. Invalid page, limit, type, sort, or THC values return HTTP 400. Limits depend on your tier. Attribute filters use source-reported tags. THC sorting uses listed maxima, and missing values sort last.Parameters
type, effect, flavor, terpene, thcMin, thcMax, breeder, slug, sort, page, limit, q
Example
// Server-side code: never expose an API key in browser code.
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": 60}],
"flavors": [{"name": "Berry"}],
"terpenes": [{"name": "Myrcene", "level": "medium"}]
}
],
"total": 123,
"page": 1,
"totalPages": 6,
"maxPage": 50,
"paginationLimitReached": false
}/api/strains/searchAutocomplete strain search. One-character queries return an empty result list. Queries over 120 characters return HTTP 400. The display-ready thcLabel identifies lab medians and listed values.Parameters
q (2–120 characters for matching)
Example
// Server-side code: never expose an API key in browser code.
fetch("https://straincompass.com/api/strains/search?q=blue+dream")Response
{
"results": [
{"slug": "blue-dream", "name": "Blue Dream", "type": "HYBRID", "thcMax": 26.26, "thcLabel": "Lab median THC 16.4% (507 tests)"},
{"slug": "blue-dream-cbd", "name": "Blue Dream CBD", "type": "CBD", "thcMax": 20.8, "thcLabel": "Listed THC 20.8%"}
]
}API Pricing
Free
$0
1,000/day per account requests
- ✓ 50 results per request
- ✓ Basic strain data
- ✓ Search endpoint
- ✓ Lab summary: test count + median THC
- ✓ Community support
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
Enterprise
$199/mo
Unlimited requests
- ✓ 500 results per request
- ✓ Everything in Pro
- ✓ Full dataset export (CSV/JSON) on request
- ✓ Dedicated support
Payments processed securely via Stripe. Subscriptions renew monthly and can be canceled at any time in your dashboard. View our Terms of Service and Privacy Policy.
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.
1K
No key / day
1K
Free / day
10K
Pro / day
∞
Enterprise