Rechercher sur MotionVideo

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

Search the videos

Gallery videos matching every facet given. Several values in one facet are alternatives (`color=red,orange` is red or orange); different facets all apply. The answer says how each model and creator was read, and, when nothing matches several facets, how many videos each matches alone.

GEThttps://motionvideo.xyz/api/catalog/search

Paramètres

  • qstringqueryFacultatif

    Keywords; every word must appear in the title, the creator's handle, the prompt or the categories.

  • categorystring[]queryFacultatif

    Gallery categories, any of them.

    Valeurs:product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccode

  • modelstring[]queryFacultatif

    Models, any of them: a name (Opus 5.5), a full name (Claude Opus 5.5), a family (Gemini) or a bare version (5.5, every model with it).

  • colorstring[]queryFacultatif

    Named colours the video contains, matched like the /color/{color} pages.

    Valeurs:redorangeyellowgreentealbluepurplepinkbrownblackwhitegray

  • colorMatchstringqueryFacultatif

    With several colours: any (default) or all of them.

    Valeurs:anyall

  • creatorstring[]queryFacultatif

    Creators, any of them: X handles (with or without @) or display names, ignoring case.

  • typestringqueryFacultatif

    Only videos sharing a prompt, or a skill.

    Valeurs:promptskill

  • sortstringqueryFacultatif

    By post date. Defaults to newest.

    Valeurs:newestoldest

  • limitintegerqueryFacultatif

    Results per page, 1 to 50. Defaults to 12.

  • offsetintegerqueryFacultatif

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

Exemple de requête

curl -X GET 'https://motionvideo.xyz/api/catalog/search'

Réponses

200

The matching videos, without prompts.

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

  • totalintegerObligatoire

    Matches before paging.

  • limitintegerObligatoire
  • offsetintegerObligatoire
  • videosVideoSummary[]Obligatoire
    Afficher les champs
    • slugstringObligatoire
    • titlestringObligatoire
    • datestringdateObligatoire
    • tagsstring[]Obligatoire

      Valeurs:promptskill

    • contentTagsstring[]Obligatoire

      Valeurs:product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccode

    • promptSharedbooleanObligatoire
    • handlestringObligatoire
    • creatorNamestring
    • avatarstringuriObligatoire
    • posterstringuriObligatoire
    • previewstringuriObligatoire
    • videostringuriObligatoire
    • widthintegerObligatoire
    • heightintegerObligatoire
    • descriptionstring
    • modelstring

      Valeurs:Opus 5.5Fable 5Fable 5.1Fable 5.2Fable 5.5Mythos 5Mythos 5.2GPT-6 AstraGemini 4 ArgonGemini 4 CarbonGemini 4 Neon

    • stackstring
    • effortstring

      Valeurs:mediumhighmax

    • iterationsstring

      Valeurs:one-shotfew-roundsmany-rounds

    • colorNamesstring[]Obligatoire

      Named colours the video contains.

      Valeurs:redorangeyellowgreentealbluepurplepinkbrownblackwhitegray

    • pageUrlstringuriObligatoire

      The video's page in English.

  • resolvedobjectObligatoire
    Afficher les champs
    • modelsobject[]Obligatoire

      How each requested model was read, in request order.

      Afficher les champs
      • requestedstringObligatoire

        As sent.

      • matchedstring[]Obligatoire

        The catalog models it matched; empty when none, which matches no videos.

    • creatorsobject[]Obligatoire

      How each requested creator was read, in request order.

      Afficher les champs
      • requestedstringObligatoire

        As sent.

      • matchedstring[]Obligatoire

        The catalog creators it matched; empty when none, which matches no videos.

      • similarstring[]Obligatoire

        With no match: up to five handles containing what was sent.

  • perFacetobject[]

    Only with no match and several facets: how many videos each facet matches alone.

    Afficher les champs
    • facetstringObligatoire

      Valeurs:qcategorymodelcolorcreatortype

    • totalintegerObligatoire

Exemple

{
  "total": 0,
  "limit": 0,
  "offset": 0,
  "videos": [
    {
      "slug": "string",
      "title": "string",
      "date": "2019-08-24",
      "tags": [
        "prompt"
      ],
      "contentTags": [
        "product-ui"
      ],
      "promptShared": true,
      "handle": "string",
      "creatorName": "string",
      "avatar": "http://example.com",
      "poster": "http://example.com",
      "preview": "http://example.com",
      "video": "http://example.com",
      "width": 0,
      "height": 0,
      "description": "string",
      "model": "Opus 5.5",
      "stack": "string",
      "effort": "medium",
      "iterations": "one-shot",
      "colorNames": [
        "red"
      ],
      "pageUrl": "http://example.com"
    }
  ],
  "resolved": {
    "models": [
      {
        "requested": "string",
        "matched": [
          "string"
        ]
      }
    ],
    "creators": [
      {
        "requested": "string",
        "matched": [
          "string"
        ],
        "similar": [
          "string"
        ]
      }
    ]
  },
  "perFacet": [
    {
      "facet": "q",
      "total": 0
    }
  ]
}

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"
  ]
}