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
Paramètres
sectionstringqueryObligatoireThe directory section, as in the site's URLs.
Valeurs:
toolsskillscreativesextrasqstringqueryFacultatifKeywords; every word must appear in the name, description, category, renderers or specialties.
filterstring[]queryFacultatifThe section's facet, any of them: pricing for tools, renderer for skills, specialty for creatives, resource type for extras (see
get-facets).Valeurs:
freefreemiumopen-sourcepaidproduct-filmsexplainers3dbrandui-motionremotionhyperframeshtmlmanimadobeblendervideo-modelsffmpeglibraryexamplespromptsdirectoryarchivecategorystring[]queryFacultatifThe section's categories, any of them, ignoring case (see
get-facets).sortstringqueryFacultatifOne of the section's sorts (see
get-facets); without one, the site's curated order.Valeurs:
addedstarsupdatednewestoldestlimitintegerqueryFacultatifResults per page, 1 to 100. Defaults to 24.
offsetintegerqueryFacultatifResults to skip, for the next page. Defaults to 0.
Exemple de requête
curl -X GET 'https://motionvideo.xyz/api/catalog/directories/search?section=tools'Réponses
200
The matching entries.
En-têtes
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.
Valeurs:
public, max-age=300, s-maxage=3600, stale-while-revalidate=86400
Corps de la réponseapplication/json
sectionstringObligatoireValeurs:
toolsskillscreativesextrastotalintegerObligatoireMatches before paging.
limitintegerObligatoireoffsetintegerObligatoireentriesDirectoryEntry[]ObligatoireAfficher les champs
idstringObligatoirenamestringObligatoiredescriptionstringObligatoirecategorystringObligatoiree.g.
Editor,AI,Skills,Studio.urlstringuriObligatoirecoverstring | nulluriObligatoireCover image (WebP), or
nullwithout one.addedAtstringdateObligatoireWhen the entry joined the directory (YYYY-MM-DD).
pricingstringTools only.
Valeurs:
freefreemiumopen-sourcepaidstarsintegerSkills only: GitHub stars.
updatedAtstringdate-timeSkills only: the repository's last push.
renderersstring[]Skills only: what renders the video, most central first.
Valeurs:
remotionhyperframeshtmlmanimadobeblendervideo-modelsffmpegspecialtiesstring[]Studios and designers only: what they're known for, strongest first.
Valeurs:
product-filmsexplainers3dbrandui-motionresourceTypestringResources only.
Valeurs:
libraryexamplespromptsdirectoryarchivepublishedAtstringdate-timeArticles only: when it was published.
Exemple
{
"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.
Corps de la réponseapplication/json
errorstringObligatoireValeurs:
invalid_parameterparameterstringObligatoiremessagestringObligatoireallowedstring[]The values the parameter can take, when it has a fixed set.
Exemple
{
"error": "invalid_parameter",
"parameter": "string",
"message": "string",
"allowed": [
"string"
]
}