Developer API

Build with the Creator Toolbox catalog.

A simple REST API to list tools and categories, verify your account, and power integrations. Free during preview.

Bearer auth

Send your key as an Authorization header on every request.

Fast + global

Edge-hosted, low latency. JSON in, JSON out.

Revocable

Rotate or revoke keys anytime from your dashboard.

Quickstart

1. Generate an API key from your API keys page.

2. Send an authenticated request:

curl "https://creator-tool.shop/api/public/v1/tools?category=youtube" \
  -H "Authorization: Bearer ctb_live_..."

3. You'll get JSON back:

{
  "count": 12,
  "categories": [{"slug":"youtube","name":"YouTube"}, …],
  "tools": [
    {
      "slug": "youtube-title-generator",
      "name": "YouTube Title Generator",
      "description": "Generate high-CTR video titles from a topic.",
      "category": "youtube",
      "url": "https://creator-tool.shop/tools/youtube-title-generator"
    }
  ]
}

Base URL

https://creator-tool.shop/api/public/v1

Authentication

Every request must include an Authorization header. Keys start with ctb_live_. Treat them like passwords — never commit them to git or expose in browser code.

Authorization: Bearer ctb_live_XXXXXXXXXXXXXXXX…

Failed auth returns 401. Missing endpoint returns 404. All errors use the shape {"error": {"status": 401, "message": "…"}}.

Endpoints

GET/me

Return the authenticated user (owner of the API key).

curl https://creator-tool.shop/api/public/v1/me \
  -H "Authorization: Bearer $CTB_KEY"
GET/tools

List tools. Query params: category, q.

curl "https://creator-tool.shop/api/public/v1/tools?q=title" \
  -H "Authorization: Bearer $CTB_KEY"

Rate limits

Preview limit: 60 requests per minute per key. Contact us for higher limits. You have up to 10 active API keys per account.

SDK examples

JavaScript / Node

const res = await fetch("https://creator-tool.shop/api/public/v1/tools", {
  headers: { Authorization: `Bearer ${process.env.CTB_KEY}` }
});
const { tools } = await res.json();

Python

import os, requests
r = requests.get(
  "https://creator-tool.shop/api/public/v1/tools",
  headers={"Authorization": f"Bearer {os.environ['CTB_KEY']}"}
)
print(r.json()["tools"])