Skip to main content
GET
/
api
/
taxonomies
/
resolve
Resolve a natural-language taxonomy term to its id/path
curl --request GET \
  --url https://app.solya.app/api/taxonomies/resolve \
  --header 'Authorization: Bearer <token>'
[
  {
    "fullPath": "Color/Blue/Turquoise",
    "id": "taxonomy-color-turquoise",
    "level": 3,
    "matchSource": "ilike",
    "path": [
      "Color",
      "Blue",
      "Turquoise"
    ],
    "score": 0.375,
    "type": "color"
  }
]

Authorizations

​
Authorization
string
header
required

User session token issued by NextAuth. For human users accessing Solya via the web application.

Query Parameters

​
q
string
required

Natural-language taxonomy term to resolve, e.g. 'bleu turquoise', 'M', 'running'

Minimum string length: 1
​
type
enum<string>

Restrict to one taxonomy type (size, color, family, gender, …); omit to search all 12 types

Available options:
size,
color,
gender,
category,
family,
sport,
style,
design,
shape,
brand_typology,
brand_typology_by_style_and_target_audience,
movement_type
​
limit
integer
default:5

Maximum matches returned PER taxonomy type (1–20). With type omitted this applies to each of the 12 types, so the response can hold up to 12 × limit nodes (default 60, max 240).

Required range: 1 <= x <= 20
​
lang
enum<string>

Restrict to a single language; omit to search all languages

Available options:
en,
fr

Response

Successful response

​
data
object[]
required
​
success
enum<boolean>
required
Available options:
true