Rechercher sur MotionVideo

Rechercher vidéos, créateurs, outils, créatifs…

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

  • sectionstringqueryObligatoire

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

    Valeurs:toolsskillscreativesextras

  • qstringqueryFacultatif

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

  • filterstring[]queryFacultatif

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

  • categorystring[]queryFacultatif

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

  • sortstringqueryFacultatif

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

    Valeurs:addedstarsupdatednewestoldest

  • limitintegerqueryFacultatif

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

  • offsetintegerqueryFacultatif

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

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

Corps de la réponseapplication/json

  • sectionstringObligatoire

    Valeurs:toolsskillscreativesextras

  • totalintegerObligatoire

    Matches before paging.

  • limitintegerObligatoire
  • offsetintegerObligatoire
  • entriesDirectoryEntry[]Obligatoire
    Afficher les champs
    • idstringObligatoire
    • namestringObligatoire
    • descriptionstringObligatoire
    • categorystringObligatoire

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

    • urlstringuriObligatoire
    • coverstring | nulluriObligatoire

      Cover image (WebP), or null without one.

    • addedAtstringdateObligatoire

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

    • pricingstring

      Tools only.

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

      Valeurs:remotionhyperframeshtmlmanimadobeblendervideo-modelsffmpeg

    • specialtiesstring[]

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

      Valeurs:product-filmsexplainers3dbrandui-motion

    • resourceTypestring

      Resources only.

      Valeurs:libraryexamplespromptsdirectoryarchive

    • publishedAtstringdate-time

      Articles 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

  • errorstringObligatoire

    Valeurs:invalid_parameter

  • parameterstringObligatoire
  • messagestringObligatoire
  • allowedstring[]

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

Exemple

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