Search the videos
Gallery videos matching every facet given. Several values in one facet are alternatives (`color=red,orange` is red or orange); different facets all apply. The answer says how each model and creator was read, and, when nothing matches several facets, how many videos each matches alone.
GEThttps://motionvideo.xyz/api/catalog/search
Параметры
qstringqueryНеобязательныйKeywords; every word must appear in the title, the creator's handle, the prompt or the categories.
categorystring[]queryНеобязательныйGallery categories, any of them.
Значения:
product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccodemodelstring[]queryНеобязательныйModels, any of them: a name (
Opus 5.5), a full name (Claude Opus 5.5), a family (Gemini) or a bare version (5.5, every model with it).colorstring[]queryНеобязательныйNamed colours the video contains, matched like the
/color/{color}pages.Значения:
redorangeyellowgreentealbluepurplepinkbrownblackwhitegraycolorMatchstringqueryНеобязательныйWith several colours:
any(default) orallof them.Значения:
anyallcreatorstring[]queryНеобязательныйCreators, any of them: X handles (with or without
@) or display names, ignoring case.typestringqueryНеобязательныйOnly videos sharing a prompt, or a skill.
Значения:
promptskillsortstringqueryНеобязательныйBy post date. Defaults to
newest.Значения:
newestoldestlimitintegerqueryНеобязательныйResults per page, 1 to 50. Defaults to 12.
offsetintegerqueryНеобязательныйResults to skip, for the next page. Defaults to 0.
Пример запроса
curl -X GET 'https://motionvideo.xyz/api/catalog/search'Ответы
200
The matching videos, without prompts.
Заголовки
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.
Значения:
public, max-age=300, s-maxage=3600, stale-while-revalidate=86400
Тело ответаapplication/json
totalintegerОбязательныйMatches before paging.
limitintegerОбязательныйoffsetintegerОбязательныйvideosVideoSummary[]ОбязательныйПоказать поля
slugstringОбязательныйtitlestringОбязательныйdatestringdateОбязательныйtagsstring[]ОбязательныйЗначения:
promptskillcontentTagsstring[]ОбязательныйЗначения:
product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccodepromptSharedbooleanОбязательныйhandlestringОбязательныйcreatorNamestringavatarstringuriОбязательныйposterstringuriОбязательныйpreviewstringuriОбязательныйvideostringuriОбязательныйwidthintegerОбязательныйheightintegerОбязательныйdescriptionstringmodelstringЗначения:
Opus 5.5Fable 5Fable 5.1Fable 5.2Fable 5.5Mythos 5Mythos 5.2GPT-6 AstraGemini 4 ArgonGemini 4 CarbonGemini 4 NeonstackstringeffortstringЗначения:
mediumhighmaxiterationsstringЗначения:
one-shotfew-roundsmany-roundscolorNamesstring[]ОбязательныйNamed colours the video contains.
Значения:
redorangeyellowgreentealbluepurplepinkbrownblackwhitegraypageUrlstringuriОбязательныйThe video's page in English.
resolvedobjectОбязательныйПоказать поля
modelsobject[]ОбязательныйHow each requested model was read, in request order.
Показать поля
requestedstringОбязательныйAs sent.
matchedstring[]ОбязательныйThe catalog models it matched; empty when none, which matches no videos.
creatorsobject[]ОбязательныйHow each requested creator was read, in request order.
Показать поля
requestedstringОбязательныйAs sent.
matchedstring[]ОбязательныйThe catalog creators it matched; empty when none, which matches no videos.
similarstring[]ОбязательныйWith no match: up to five handles containing what was sent.
perFacetobject[]Only with no match and several facets: how many videos each facet matches alone.
Показать поля
facetstringОбязательныйЗначения:
qcategorymodelcolorcreatortypetotalintegerОбязательный
Пример
{
"total": 0,
"limit": 0,
"offset": 0,
"videos": [
{
"slug": "string",
"title": "string",
"date": "2019-08-24",
"tags": [
"prompt"
],
"contentTags": [
"product-ui"
],
"promptShared": true,
"handle": "string",
"creatorName": "string",
"avatar": "http://example.com",
"poster": "http://example.com",
"preview": "http://example.com",
"video": "http://example.com",
"width": 0,
"height": 0,
"description": "string",
"model": "Opus 5.5",
"stack": "string",
"effort": "medium",
"iterations": "one-shot",
"colorNames": [
"red"
],
"pageUrl": "http://example.com"
}
],
"resolved": {
"models": [
{
"requested": "string",
"matched": [
"string"
]
}
],
"creators": [
{
"requested": "string",
"matched": [
"string"
],
"similar": [
"string"
]
}
]
},
"perFacet": [
{
"facet": "q",
"total": 0
}
]
}400
A parameter is unknown or has a value it can't take.
Тело ответаapplication/json
errorstringОбязательныйЗначения:
invalid_parameterparameterstringОбязательныйmessagestringОбязательныйallowedstring[]The values the parameter can take, when it has a fixed set.
Пример
{
"error": "invalid_parameter",
"parameter": "string",
"message": "string",
"allowed": [
"string"
]
}