TapColor Developer API

Base URL

Authentication

Every request must include the api-key header. Requests without a valid key return 401. Keys can be revoked at any time.

Official SDKs

Prefer a typed client over raw HTTP? Use the official library — zero dependencies, with full TypeScript types and auto-pagination.

JavaScript / TypeScript

import { TapColor } from "@tapcolorapp/api";

const tc = new TapColor({ apiKey: "YOUR_API_KEY" });

const { items } = await tc.coloringPages({ category: "animals", limit: 20 });
items.forEach((c) => console.log(c.subtopic, c.url));

// Or iterate EVERY collection, auto-paginated:
for await (const c of tc.allColoringPages({ category: "animals" })) {
  console.log(c.subtopicSlug);
}

npm ↗ · JSR ↗ · works in Node 18+, Deno, Bun & modern browsers.

Python

from tapcolor import TapColor

tc = TapColor("YOUR_API_KEY")

page = tc.coloring_pages(category="animals", limit=20)
for c in page["items"]:
    print(c["subtopic"], "->", c["url"])

# Or iterate EVERY collection, auto-paginated:
for c in tc.all_coloring_pages(category="animals"):
    print(c["subtopicSlug"])

PyPI ↗ · requires Python 3.8+.

AI assistants (MCP)

Let Claude, Cursor and other Model Context Protocol clients browse the catalog. Add this to your client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "tapcolor": {
      "command": "npx",
      "args": ["-y", "@tapcolorapp/mcp"],
      "env": { "TAPCOLOR_API_KEY": "YOUR_API_KEY" }
    }
  }
}

npm ↗ · exposes list_categories and list_coloring_pages as tools.

Try it live

Run a real request straight from your browser — no setup. Paste an api-key, pick an endpoint, and hit Run.

Rate limits & errors

List collections

Returns a list of collections with filtering, search and pagination.

Query parameters

Example request

curl "https://api.tapcolor.app/v1/coloring-pages?category=animals&limit=20" \
  -H "api-key: YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.tapcolor.app/v1/coloring-pages",
    params={"category": "animals", "limit": 20},
    headers={"api-key": "YOUR_API_KEY"},
)
data = resp.json()
print(data["total"], "collections")
for item in data["items"]:
    print(item["subtopic"], "->", item["url"])

const res = await fetch(
  "https://api.tapcolor.app/v1/coloring-pages?category=animals&limit=20",
  { headers: { "api-key": "YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data.total, "collections");
data.items.forEach((it) => console.log(it.subtopic, it.url));

Example response

{
  "total": 95,
  "limit": 20,
  "offset": 0,
  "count": 20,
  "items": [
    {
      "category": "Animals",
      "categorySlug": "animals",
      "subtopic": "Arctic Animals",
      "subtopicSlug": "arctic-animals",
      "count": 35,
      "url": "https://tapcolor.app/coloring-pages/animals/arctic-animals/",
      "image": "https://img.tapcolor.app/images/animals/arctic-animals/seal.jpg"
    }
  ]
}

Response fields

Pagination

Page through results with limit + offset; stop once offset + count ≥ total.

offset = 0
while True:
    r = requests.get(URL, params={"category": "animals", "limit": 100, "offset": offset},
                     headers={"api-key": KEY}).json()
    for item in r["items"]:
        ...                      # process each collection
    offset += r["count"]
    if offset >= r["total"]:
        break

List categories

Returns all 25 categories with the number of collections and pages in each.

Example request

curl "https://api.tapcolor.app/v1/categories" \
  -H "api-key: YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.tapcolor.app/v1/categories",
    headers={"api-key": "YOUR_API_KEY"},
)
for c in resp.json()["items"]:
    print(c["slug"], "->", c["pages"], "pages")

const res = await fetch(
  "https://api.tapcolor.app/v1/categories",
  { headers: { "api-key": "YOUR_API_KEY" } }
);
const data = await res.json();
data.items.forEach((c) => console.log(c.slug, c.pages));

Example response

{
  "total": 25,
  "items": [
    {
      "name": "Animals",
      "slug": "animals",
      "subtopics": 95,
      "pages": 3324,
      "url": "https://tapcolor.app/coloring-pages/animals/"
    }
  ]
}

Response fields

Category slugs

All 25 valid values for the category parameter, straight from the live catalog.