API Reference

Base URL: https://stemcut.org/api

All endpoints require an X-API-Key header. Get a free key →

Authentication

Include your API key in every request:

fetch('https://stemcut.org/api/strains', {
  headers: { 'X-API-Key': 'sc_live_...' }
})

Strains

GET/api/strains

Paginated list of strains.

ParamTypeDescription
pagenumberPage number (default: 1)
limitnumberResults per page, max 50 (default: 20)
typestringFilter by type: Indica, Sativa, Hybrid
searchstringSearch by strain name
acceptedbooleanOnly community-accepted strains
GET/api/strains/:id

Full strain detail including all relations (descriptions, images, ratings, tastings, grow stats, parents, hybrids).

GET/api/strains/search?q=

Quick search by strain name. Returns up to 20 results.

ParamTypeDescription
qstringSearch query (min 2 chars)

Rate Limits

Free API keys are limited to 100 requests per minute. Exceeding this limit returns a 429 status.

Error Codes

CodeMeaning
401Missing or invalid API key
403API key not yet verified or pending review
404Resource not found
429Rate limit exceeded
500Server error