---
title: "Search strains, breeders and articles"
method: GET
path: "/search"
tags: ["Search"]
---

# Search strains, breeders and articles

`GET /search`

## Request

- Base URL: `https://www.primecutsnursery.com/api/v1`
- URL: `https://www.primecutsnursery.com/api/v1/search`
- Auth: none required

Substring search across the three entity types; up to `limit` of each. Cached at the CDN for 1 hour (`Cache-Control: public, s-maxage=3600`).

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Results

- object
  - `api_version` string, required
  - `publisher` Publisher, required
    - `name` string, required
    - `url` string, uri, required: Site root
    - `@id` string, uri, required: schema.org Organization @id used across the site's JSON-LD
  - `meta` Meta, required
    - `generated_at` string, date-time, required: When this payload was produced
    - `source` string, required: Where the data came from: 'repo' (curated site content) or 'live-inventory' (the nursery's live stock count, same figures as /live-inventory)
    - `as_of` string, date-time: For live data: when the underlying inventory snapshot was taken
    - `total` integer: Total matches before paging
    - `limit` integer
    - `offset` integer
    - `html_url` string, uri: Canonical HTML page for this resource
    - `notes` string[]: Caveats an agent should surface to a user
    - `interpreted` string[]: Search endpoints: how a free-text q was read (e.g. 'flowering ≤ 8 weeks')
  - `data` SearchResult, required
    - `strains` StrainMatch[], required
      - `slug` string, required: Encyclopedia slug
      - `name` string, required
      - `aliases` string[], required
      - `type` 'Indica' | 'Sativa' | 'Hybrid', required
      - `ratio` string: Indica/sativa ratio as published
      - `thc_range` string
      - `breeder` string, required: Breeder as written in the encyclopedia (free text)
      - `breeders` object[], required: Resolved breeder hub(s) — a strain may belong to several (collaborations/selections)
        - `slug` string, required
        - `name` string, required
        - `url` string, uri, required: Canonical HTML page for this resource
      - `lineage` string, required
      - `parents` object[], required
        - `name` string, required
        - `slug` string, nullable, required: Encyclopedia slug when the parent is documented
      - `dominant_terpenes` string[], required
      - `flower_time` string
      - `url` string, uri, required: Encyclopedia page
      - `api_url` string, uri, required: This strain's detail endpoint
      - `menu` MenuLink, required: Present only when Prime Cuts sells this cultivar as clones
        - `slug` string, required: Menu-page slug, e.g. wedding-cake-cannabis-clones
        - `url` string, uri, required: Menu page
        - `api_availability_url` string, uri, required: Live availability endpoint for this strain
      - `updated_at` string, date-time: Last content change (from git history)
      - `matched_on` string[], required: Factual fields this strain matched, e.g. 'flowering 8 weeks', 'lineage: Zkittlez x Gelato'
    - `breeders` BreederSummary[], required
      - `slug` string, required
      - `name` string, required
      - `location` string, nullable
      - `summary` string, required: Documented public history of the breeder
      - `strain_count` integer, required: Encyclopedia cultivars attributed to this breeder
      - `on_menu_count` integer, required: Of those, how many Prime Cuts sells as clones
      - `url` string, uri, required: Breeder hub page
      - `api_url` string, uri, required: Canonical HTML page for this resource
      - `updated_at` string, date-time
    - `articles` ArticleSummary[], required
      - `slug` string, required
      - `kind` 'authority' | 'local' | 'guide' | 'buying' | 'article', required
      - `title` string, required
      - `description` string, required
      - `headings` string[], required
      - `url` string, uri, required: Canonical HTML page for this resource
      - `api_url` string, uri, required: Canonical HTML page for this resource
      - `updated_at` string, date-time
    - `interpreted` string[]: How the free-text query was read for cultivars

## Other responses

- `400`: Missing or too-short q

---

[API](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api.md) · [All operations](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api/revisions/ecf137a90e29?raw)