Public API · v1 · JSON

REST API для цвета

Получай трендовые цвета, конвертируй форматы и генерируй гармоничные палитры программно. Без ключа, без лимитов на чтение, прямо из CDN.

2,847,193 Запросов в месяц

18,492 Палитр сгенерировано

41 ms Средний отклик

99.97% Аптайм

Endpoints

GET /api/v1/trending Топ-цвета за сегодня

Request

curl https://idcolor.ru/api/v1/trending
  -H "Accept: application/json"

Response

{
  "date": "2026-06-05",
  "trending": [
    {"hex": "#A47864", "name": "Mocha Mousse", "uses": 1284},
    {"hex": "#7AA2F7", "name": "Tokyo Blue", "uses": 1102},
    {"hex": "#A6E3A1", "name": "Catppuccin Green", "uses": 947}
  ]
}

GET /api/v1/palette/random Случайная гармоничная палитра

Request

curl https://idcolor.ru/api/v1/palette/random?
  scheme=triad&count=5

Response

{
  "scheme": "triad",
  "colors": [
    {"hex": "#F38BA8", "hsl": [350, 80, 75]},
    {"hex": "#8BF3A8", "hsl": [110, 80, 75]},
    {"hex": "#A88BF3", "hsl": [230, 80, 75]},
    {"hex": "#F3CC8B", "hsl": [40, 80, 75]},
    {"hex": "#8BCCF3", "hsl": [200, 80, 75]}
  ]
}

GET /api/v1/convert/:hex Все форматы цвета

Request

curl https://idcolor.ru/api/v1/convert/B69ADF

Response

{
  "hex": "#B69ADF",
  "rgb": [182, 154, 223],
  "hsl": [264, 49, 74],
  "cmyk": [18, 31, 0, 13],
  "name": "Light Purple",
  "contrast": {
    "white": 2.41,
    "black": 8.71
  }
}

GET /api/v1/palettes/:family Дизайн-системные палитры

Request

curl https://idcolor.ru/api/v1/palettes/catppuccin?
  flavor=mocha

Response

{
  "family": "Catppuccin",
  "name": "Catppuccin Mocha",
  "credit": "Catppuccin org",
  "year": 2022,
  "colors": [
    {"name": "Rosewater", "hex": "#f5e0dc"},
    {"name": "Flamingo", "hex": "#f2cdcd"},
    ...18 more
  ]
}

Аутентификация

Чтение из API не требует ключа. Лимит — 60 запросов в минуту с одного IP. Для расширенного доступа (запись, webhooks, кастомные палитры) — пиши на api@idcolor.ru.

SDK

В планах: JavaScript / Python / Swift SDK. Сейчас можно работать напрямую через fetch, requests или любой HTTP-клиент.