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
Parameters
sectionstringqueryRequiredThe directory section, as in the site's URLs.
Values:
toolsskillscreativesextrasqstringqueryOptionalKeywords; every word must appear in the name, description, category, renderers or specialties.
filterstring[]queryOptionalThe section's facet, any of them: pricing for tools, renderer for skills, specialty for creatives, resource type for extras (see
get-facets).Values:
freefreemiumopen-sourcepaidproduct-filmsexplainers3dbrandui-motionremotionhyperframeshtmlmanimadobeblendervideo-modelsffmpeglibraryexamplespromptsdirectoryarchivecategorystring[]queryOptionalThe section's categories, any of them, ignoring case (see
get-facets).sortstringqueryOptionalOne of the section's sorts (see
get-facets); without one, the site's curated order.Values:
addedstarsupdatednewestoldestlimitintegerqueryOptionalResults per page, 1 to 100. Defaults to 24.
offsetintegerqueryOptionalResults to skip, for the next page. Defaults to 0.
Example request
curl -X GET 'https://motionvideo.xyz/api/catalog/directories/search?section=tools'Responses
200
The matching entries.
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
sectionstringRequiredValues:
toolsskillscreativesextrastotalintegerRequiredMatches before paging.
limitintegerRequiredoffsetintegerRequiredentriesDirectoryEntry[]RequiredShow fields
idstringRequirednamestringRequireddescriptionstringRequiredcategorystringRequirede.g.
Editor,AI,Skills,Studio.urlstringuriRequiredcoverstring | nulluriRequiredCover image (WebP), or
nullwithout one.addedAtstringdateRequiredWhen the entry joined the directory (YYYY-MM-DD).
pricingstringTools only.
Values:
freefreemiumopen-sourcepaidstarsintegerSkills only: GitHub stars.
updatedAtstringdate-timeSkills only: the repository's last push.
renderersstring[]Skills only: what renders the video, most central first.
Values:
remotionhyperframeshtmlmanimadobeblendervideo-modelsffmpegspecialtiesstring[]Studios and designers only: what they're known for, strongest first.
Values:
product-filmsexplainers3dbrandui-motionresourceTypestringResources only.
Values:
libraryexamplespromptsdirectoryarchivepublishedAtstringdate-timeArticles only: when it was published.
Example
{
"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.
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"
]
}