Buscar en MotionVideo

Buscar vídeos, creadores, herramientas, creativos…

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

Parámetros

  • sectionstringqueryObligatorio

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

    Valores:toolsskillscreativesextras

  • qstringqueryOpcional

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

  • filterstring[]queryOpcional

    The section's facet, any of them: pricing for tools, renderer for skills, specialty for creatives, resource type for extras (see get-facets).

    Valores:freefreemiumopen-sourcepaidproduct-filmsexplainers3dbrandui-motionremotionhyperframeshtmlmanimadobeblendervideo-modelsffmpeglibraryexamplespromptsdirectoryarchive

  • categorystring[]queryOpcional

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

  • sortstringqueryOpcional

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

    Valores:addedstarsupdatednewestoldest

  • limitintegerqueryOpcional

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

  • offsetintegerqueryOpcional

    Results to skip, for the next page. Defaults to 0.

Ejemplo de solicitud

curl -X GET 'https://motionvideo.xyz/api/catalog/directories/search?section=tools'

Respuestas

200

The matching entries.

Cabeceras

  • 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.

    Valores:public, max-age=300, s-maxage=3600, stale-while-revalidate=86400

Cuerpo de la respuestaapplication/json

  • sectionstringObligatorio

    Valores:toolsskillscreativesextras

  • totalintegerObligatorio

    Matches before paging.

  • limitintegerObligatorio
  • offsetintegerObligatorio
  • entriesDirectoryEntry[]Obligatorio
    Mostrar campos
    • idstringObligatorio
    • namestringObligatorio
    • descriptionstringObligatorio
    • categorystringObligatorio

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

    • urlstringuriObligatorio
    • coverstring | nulluriObligatorio

      Cover image (WebP), or null without one.

    • addedAtstringdateObligatorio

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

    • pricingstring

      Tools only.

      Valores: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.

      Valores:remotionhyperframeshtmlmanimadobeblendervideo-modelsffmpeg

    • specialtiesstring[]

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

      Valores:product-filmsexplainers3dbrandui-motion

    • resourceTypestring

      Resources only.

      Valores:libraryexamplespromptsdirectoryarchive

    • publishedAtstringdate-time

      Articles only: when it was published.

Ejemplo

{
  "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.

Cuerpo de la respuestaapplication/json

  • errorstringObligatorio

    Valores:invalid_parameter

  • parameterstringObligatorio
  • messagestringObligatorio
  • allowedstring[]

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

Ejemplo

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