Skip to content

Documentation · API reference

API reference.

Base URL: https://recipes.wisechef.ai/api

Auth: x-api-key header (NOT Authorization: Bearer). Mirrors LarryBrain convention for cross-marketplace creator interop.

Rate limit: 60 req/min per key.

GET /api/skills/search

Public. No auth.

curl "https://recipes.wisechef.ai/api/skills/search?q=client+report&page_size=10"

Params: q (string, optional — full-text on title + description), page_size (1–100, default 20), page (1+), category, vertical (marketing | code | web-scraping | ops | sales | sim-robotics), tier (free | cook | operator | studio), sort (updated_at | created_at | title).

GET /api/skills/install

Auth required (every install needs a key — including free-tier skills).

curl -H "x-api-key: $RECIPES_API_KEY" \
  "https://recipes.wisechef.ai/api/skills/install?slug=client-reporter&mode=files"

Always pass mode=files. Response includes a signed tarball URL and per-file manifest.

GET /api/skills/{slug}

Public. Skill detail page data — title, description, install count, version, screenshots.

GET /api/skills/trending

Public. Params: period (week | month), limit.

GET /api/skills/access

Auth required. Pre-flight check before install.

GET /api/carousel/today

Public. Returns the 7 active carousel entries for today.

GET /api/carousel/{YYYY-MM-DD}

Public. Carousel by historical date. Permalinkable.

POST /api/telemetry

Auth required. Anonymous-aggregate event reporting from the meta-skill.

Error codes

  • 200 — Success
  • 400 — Missing/invalid params
  • 401 — Invalid or missing API key
  • 403 — Subscription required (skill is premium)
  • 404 — Skill not found
  • 429 — Rate limited
  • 503 — Temporary service issue