---
title: "Find colors by name"
method: POST
path: "/api/v1/find-colors"
---

# Find colors by name

`POST /api/v1/find-colors`

## Request

- Base URL: `https://pickshade.com`
- URL: `https://pickshade.com/api/v1/find-colors`
- Auth: none declared

Search color names by words, like "sage", "dusty rose", "midnight blue" or "бордовый", and get their HEX values. Searches common names in English and Russian and about 30 000 extended color names. Use it to turn a description into real colors.

## Request body

- object
  - `query` string, required: Words to look for in color names
  - `limit` integer
  - `locale` 'en' | 'ru': Language for color names

## Response `200`

Result

## Other responses

- `400`: Invalid input
- `429`: Too many requests. See the Retry-After header

---

[API](https://skmtc.dev/pickshade/apis/pickshade-color-api.md) · [All operations](https://skmtc.dev/pickshade/apis/pickshade-color-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickshade/apis/pickshade-color-api/revisions/00f0b7c55ea7?raw)