CBD Surgeons API Documentation

Quick Start

1. No Auth Required

Read endpoints are public. No API key needed to get started.

curl https://api.surgeonsolutions.org/v1/health

2. Get Products

Fetch all CBD products from surgeonsolution.io

curl https://api.surgeonsolutions.org/v1/products

3. Search Keywords

Find SEO keywords for content creation

curl "https://api.surgeonsolutions.org/v1/seo/keywords/search?q=gummies"

Endpoints

SYSTEM

GET /v1/health Health check and version info

Response

{
  "ok": true,
  "ts": 1704200000000,
  "version": "2.1",
  "runtime": "deno",
  "server": "SRGN-1",
  "uptime_ms": 86400000
}

Live Response

PRODUCTS

GET /v1/products List all CBD products

Query Parameters

Name	Type	Description
category	string	Filter by category: gummies, oils, topicals, pets, drinks
featured	boolean	Return only featured products
limit	integer	Max products to return (default: 50, max: 100)

Example Response

{
  "success": true,
  "count": 25,
  "products": [
    {
      "id": "gid://shopify/Product/123",
      "title": "CBD + CBN Sleep Gummies",
      "slug": "cbdandcbninfusededibles",
      "price": 49.99,
      "category": "gummies",
      "url": "https://surgeonsolution.io/products/cbdandcbninfusededibles",
      "inStock": true
    }
  ]
}

GET /v1/collections List product collections

Example Response

{
  "success": true,
  "collections": [
    {
      "id": "surgeons-gummies-express",
      "title": "CBD Gummies",
      "url": "/collections/surgeons-gummies-express",
      "productCount": 8
    },
    {
      "id": "oils-edibles",
      "title": "CBD Oils & Tinctures",
      "url": "/collections/oils-edibles",
      "productCount": 12
    }
  ]
}

SEO & KEYWORDS

GET /v1/seo/keywords Get keyword database

Response

{
  "success": true,
  "count": 150,
  "keywords": [
    {
      "keyword": "CBD gummies",
      "volume": 74000,
      "difficulty": 65,
      "intent": "transactional",
      "targetPage": "/collections/surgeons-gummies-express"
    }
  ]
}

Live Response

GET /v1/seo/keywords/search Search keywords by query

Query Parameters

Name	Type	Description
q required	string	Search query

Example

GET /v1/seo/keywords/search?q=sleep

{
  "success": true,
  "query": "sleep",
  "results": [
    { "keyword": "CBD for sleep", "volume": 22000 },
    { "keyword": "CBN sleep gummies", "volume": 4400 },
    { "keyword": "best CBD for sleep", "volume": 8100 }
  ]
}

GET /v1/subdomains List SEO subdomains

Query Parameters

Name	Type	Description
domain	string	Filter by parent domain

Example Response

{
  "success": true,
  "count": 19,
  "subdomains": [
    {
      "subdomain": "gummies",
      "parent_domain": "surgeonsolution.io",
      "full_domain": "gummies.surgeonsolution.io",
      "primary_keyword": "CBD gummies",
      "target_url": "https://surgeonsolution.io/collections/surgeons-gummies-express",
      "status": "pending"
    }
  ]
}

Live Response

GET /v1/subdomains/export Export DNS zone records

Query Parameters

Name	Type	Description
format	string	json (default) or dns (zone file format)

DNS Format Example

; SEO Subdomains DNS Records
; Generated: 2026-01-02T20:00:00.000Z

gummies       CNAME  shops.myshopify.com.
sleep-gummies CNAME  shops.myshopify.com.
cbd-oil       CNAME  shops.myshopify.com.
shop          CNAME  ai.surgeonsolutions.org.
blog          CNAME  ai.surgeonsolutions.org.

AI & CHAT

POST /v1/bud/chat Chat with BUD AI (rate-limited)

Request Body

{
  "message": "What CBD products help with sleep?",
  "conversationId": "optional-session-id"
}

Response

{
  "response": "For sleep, I recommend our CBN Sleep Gummies...",
  "conversationId": "conv_abc123",
  "products": [
    {
      "title": "CBD + CBN Sleep Gummies",
      "url": "https://surgeonsolution.io/products/cbdandcbninfusededibles"
    }
  ]
}

Rate limit: 10 requests/minute per IP

Authentication

Public Endpoints (No Auth)

All GET endpoints are publicly accessible. No API key required.

curl https://api.surgeonsolutions.org/v1/products

Authenticated Endpoints

Write operations require an API key in the X-API-Key header.

curl -H "X-API-Key: your_key_here" \
  https://api.surgeonsolutions.org/v1/protected-endpoint

Contact api@surgeonsolutions.org for API key access.

SDKs & Integrations

ChatGPT Custom GPT

Use our API with ChatGPT Actions for product recommendations.

Import OpenAPI spec:
/openapi.json

Python

Simple requests-based integration.

import requests

r = requests.get(
  "https://api.surgeonsolutions.org/v1/products"
)
products = r.json()["products"]

JavaScript

Fetch API integration.

const res = await fetch(
  "https://api.surgeonsolutions.org/v1/products"
);
const { products } = await res.json();