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/strainsPaginated list of strains.
| Param | Type | Description |
|---|---|---|
| page | number | Page number (default: 1) |
| limit | number | Results per page, max 50 (default: 20) |
| type | string | Filter by type: Indica, Sativa, Hybrid |
| search | string | Search by strain name |
| accepted | boolean | Only community-accepted strains |
GET
/api/strains/:idFull 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.
| Param | Type | Description |
|---|---|---|
| q | string | Search 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
| Code | Meaning |
|---|---|
| 401 | Missing or invalid API key |
| 403 | API key not yet verified or pending review |
| 404 | Resource not found |
| 429 | Rate limit exceeded |
| 500 | Server error |