Search a directory
Entries of one directory section matching every facet given: tools (filter by pricing), skills (by renderer), creatives (studios and designers, by specialty) or extras (articles and resources, by resource type).
GEThttps://motionvideo.xyz/api/catalog/directories/search
パラメーター
sectionstringquery必須The directory section, as in the site's URLs.
値:
toolsskillscreativesextrasqstringquery任意Keywords; every word must appear in the name, description, category, renderers or specialties.
filterstring[]query任意The section's facet, any of them: pricing for tools, renderer for skills, specialty for creatives, resource type for extras (see
get-facets).値:
freefreemiumopen-sourcepaidproduct-filmsexplainers3dbrandui-motionremotionhyperframeshtmlmanimadobeblendervideo-modelsffmpeglibraryexamplespromptsdirectoryarchivecategorystring[]query任意The section's categories, any of them, ignoring case (see
get-facets).sortstringquery任意One of the section's sorts (see
get-facets); without one, the site's curated order.値:
addedstarsupdatednewestoldestlimitintegerquery任意Results per page, 1 to 100. Defaults to 24.
offsetintegerquery任意Results to skip, for the next page. Defaults to 0.
リクエスト例
curl -X GET 'https://motionvideo.xyz/api/catalog/directories/search?section=tools'レスポンス
200
The matching entries.
ヘッダー
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
sectionstring必須値:
toolsskillscreativesextrastotalinteger必須Matches before paging.
limitinteger必須offsetinteger必須entriesDirectoryEntry[]必須フィールドを表示
idstring必須namestring必須descriptionstring必須categorystring必須e.g.
Editor,AI,Skills,Studio.urlstringuri必須coverstring | nulluri必須Cover image (WebP), or
nullwithout one.addedAtstringdate必須When the entry joined the directory (YYYY-MM-DD).
pricingstringTools only.
値:
freefreemiumopen-sourcepaidstarsintegerSkills only: GitHub stars.
updatedAtstringdate-timeSkills only: the repository's last push.
renderersstring[]Skills only: what renders the video, most central first.
値:
remotionhyperframeshtmlmanimadobeblendervideo-modelsffmpegspecialtiesstring[]Studios and designers only: what they're known for, strongest first.
値:
product-filmsexplainers3dbrandui-motionresourceTypestringResources only.
値:
libraryexamplespromptsdirectoryarchivepublishedAtstringdate-timeArticles only: when it was published.
例
{
"section": "tools",
"total": 0,
"limit": 0,
"offset": 0,
"entries": [
{
"id": "string",
"name": "string",
"description": "string",
"category": "string",
"url": "http://example.com",
"cover": "http://example.com",
"addedAt": "2019-08-24",
"pricing": "free",
"stars": 0,
"updatedAt": "2019-08-24T14:15:22Z",
"renderers": [
"remotion"
],
"specialties": [
"product-films"
],
"resourceType": "library",
"publishedAt": "2019-08-24T14:15:22Z"
}
]
}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"
]
}