Search MotionVideo

Search videos, creators, tools, creatives…

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

  • sectionstringqueryRequired

    The directory section, as in the site's URLs.

    Values:toolsskillscreativesextras

  • qstringqueryOptional

    Keywords; every word must appear in the name, description, category, renderers or specialties.

  • filterstring[]queryOptional

    The 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-modelsffmpeglibraryexamplespromptsdirectoryarchive

  • categorystring[]queryOptional

    The section's categories, any of them, ignoring case (see get-facets).

  • sortstringqueryOptional

    One of the section's sorts (see get-facets); without one, the site's curated order.

    Values:addedstarsupdatednewestoldest

  • limitintegerqueryOptional

    Results per page, 1 to 100. Defaults to 24.

  • offsetintegerqueryOptional

    Results 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-Controlstring

    Browsers 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

  • sectionstringRequired

    Values:toolsskillscreativesextras

  • totalintegerRequired

    Matches before paging.

  • limitintegerRequired
  • offsetintegerRequired
  • entriesDirectoryEntry[]Required
    Show fields
    • idstringRequired
    • namestringRequired
    • descriptionstringRequired
    • categorystringRequired

      e.g. Editor, AI, Skills, Studio.

    • urlstringuriRequired
    • coverstring | nulluriRequired

      Cover image (WebP), or null without one.

    • addedAtstringdateRequired

      When the entry joined the directory (YYYY-MM-DD).

    • pricingstring

      Tools only.

      Values:freefreemiumopen-sourcepaid

    • starsinteger

      Skills only: GitHub stars.

    • updatedAtstringdate-time

      Skills only: the repository's last push.

    • renderersstring[]

      Skills only: what renders the video, most central first.

      Values:remotionhyperframeshtmlmanimadobeblendervideo-modelsffmpeg

    • specialtiesstring[]

      Studios and designers only: what they're known for, strongest first.

      Values:product-filmsexplainers3dbrandui-motion

    • resourceTypestring

      Resources only.

      Values:libraryexamplespromptsdirectoryarchive

    • publishedAtstringdate-time

      Articles 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

  • errorstringRequired

    Values:invalid_parameter

  • parameterstringRequired
  • messagestringRequired
  • allowedstring[]

    The values the parameter can take, when it has a fixed set.

Example

{
  "error": "invalid_parameter",
  "parameter": "string",
  "message": "string",
  "allowed": [
    "string"
  ]
}