Skip to content
Developer API

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 integration

Tell 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 schema

Strain 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.

GET/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
}
GET/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
Get a free key
Most Popular

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