Get the filters
Every value the search endpoints filter by, with how many videos or entries carry it: video categories (with titles and descriptions), models, colours and types; each directory section's filters, categories and sorts; and the move families.
GEThttps://motionvideo.xyz/api/catalog/facets
Example request
curl -X GET 'https://motionvideo.xyz/api/catalog/facets'Responses
200
The filter values.
Headers
Cache-ControlstringBrowsers reuse a response for 5 minutes and shared caches for an hour, then may serve it stale for up to a day while they revalidate.
Values:
public, max-age=300, s-maxage=3600, stale-while-revalidate=86400
Response bodyapplication/json
videosobjectRequiredShow fields
totalintegerRequiredcreatorsintegerRequiredHow many creators have videos.
categoriesobject[]RequiredShow fields
idstringRequiredValues:
product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccodecountintegerRequiredtitlestringRequireddescriptionstringRequiredurlstringuriRequired
modelsobject[]RequiredShow fields
idstringRequiredValues:
Opus 5.5Fable 5Fable 5.1Fable 5.2Fable 5.5Mythos 5Mythos 5.2GPT-6 AstraGemini 4 ArgonGemini 4 CarbonGemini 4 NeoncountintegerRequiredfullNamestringRequiredfamilystringRequired
colorsobject[]RequiredShow fields
idstringRequiredValues:
redorangeyellowgreentealbluepurplepinkbrownblackwhitegraycountintegerRequiredhexstringRequired
typesFacetCount[]RequiredShow fields
idstringRequiredcountintegerRequired
sortsstring[]RequiredValues:
newestoldest
directoriesobject[]RequiredShow fields
sectionstringRequiredValues:
toolsskillscreativesextrastotalintegerRequiredfiltersFacetCount[]RequiredShow fields
idstringRequiredcountintegerRequired
categoriesFacetCount[]RequiredShow fields
idstringRequiredcountintegerRequired
sortsstring[]RequiredValues:
addedstarsupdatednewestoldest
movesobjectRequiredShow fields
totalintegerRequiredfamiliesobject[]RequiredShow fields
idstringRequiredValues:
timingtypetransitionsuivectorgenerativecameratexturedatasoundcountintegerRequired
Example
{
"videos": {
"total": 0,
"creators": 0,
"categories": [
{
"id": "product-ui",
"count": 0,
"title": "string",
"description": "string",
"url": "http://example.com"
}
],
"models": [
{
"id": "Opus 5.5",
"count": 0,
"fullName": "string",
"family": "string"
}
],
"colors": [
{
"id": "red",
"count": 0,
"hex": "string"
}
],
"types": [
{
"id": "string",
"count": 0
}
],
"sorts": [
"newest"
]
},
"directories": [
{
"section": "tools",
"total": 0,
"filters": [
{
"id": "string",
"count": 0
}
],
"categories": [
{
"id": "string",
"count": 0
}
],
"sorts": [
"added"
]
}
],
"moves": {
"total": 0,
"families": [
{
"id": "timing",
"count": 0
}
]
}
}400
A parameter is unknown or has a value it can't take.
Response bodyapplication/json
errorstringRequiredValues:
invalid_parameterparameterstringRequiredmessagestringRequiredallowedstring[]The values the parameter can take, when it has a fixed set.
Example
{
"error": "invalid_parameter",
"parameter": "string",
"message": "string",
"allowed": [
"string"
]
}