Chinese Color AtlasCATHYCOLOR API
161 COLORS · SERVER-SIDE ACCESS
support@chinesecoloratlas.com

Bring traditional Chinese colors to your product.

Match colors and search color names with a server-side API for your website, app, or design tool. Explore 161 traditional Chinese colors.

COLOR MATCHING · NAME SEARCH

Match by color or search by name.

Find similar traditional colors from an input color, or search the 161-color library by name. Your product connects to the API through its own backend.

Email API support ↗
—Loading interest count…
Contact API support ↗

New API sales and new account provisioning are paused. Existing customers can continue using the API with their active keys; renewals and support continue.

API FEATURES

Find a traditional Chinese color for your RGB value.

Match an input color to find similar traditional colors, or search by name. Your backend can also check current usage and library details. The API includes 161 colors, not the full atlas or a full-library download.

POST/v1/match

Match a color

Compare an input color with the library to find similar traditional colors.

GET/v1/search

Search by name

Search the color library by name.

GET/v1/usage

Check usage

See match inputs and searches used in the current UTC month.

GET/v1/library

View library details

Check the current library version and the number of included colors.

CURRENT API USAGE

Usage limits for existing customers.

COLOR MATCHING

2,000 input colors

Per UTC calendar month; each input color counts once.

NAME SEARCH

1,000 searches

Per UTC calendar month.

QUOTA RESET

UTC month · no rollover

Limits reset at the start of each UTC month, not on your billing date. Your first period may be partial. Requests are refused at the cap; there are no extra usage charges.

FOR EXISTING CUSTOMERS

Your current API access continues.

Existing customer accounts can keep using the API with their active keys. New API sales and account provisioning are paused.

Your active API key remains usable. Never send your private key or API key to support.

  1. 01

    Keep using your active key

    Call the API from your server as usual. Existing API keys remain active.

  2. 02

    Check usage and setup

    Use the integration guide to review your current usage and keep your key stored securely.

  3. 03

    Contact API support

    Existing customer support and renewals continue. Never send your private key or API key by email.

AVAILABILITY & USAGE

New sales and provisioning are paused.

We are not accepting new API sales or provisioning new customer accounts. Existing customers can continue using the API with their active keys; renewals and support continue. Usage limits reset at the start of each UTC calendar month, and unused quota does not roll over. This Beta does not include a service-level agreement (SLA).

  • Make API requests from your server. Direct browser calls are not supported.
  • The API includes 161 colors, not the full atlas or a full-library download.
  • When a limit is reached, further requests of that type are refused. There are no automatic overage charges or top-ups.