Pesquisar no MotionVideo

Pesquisar vídeos, criadores, ferramentas, criativos…

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

Parâmetros

  • qstringqueryOpcional

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

  • categorystring[]queryOpcional

    Gallery categories, any of them.

    Valores:product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccode

  • modelstring[]queryOpcional

    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[]queryOpcional

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

    Valores:redorangeyellowgreentealbluepurplepinkbrownblackwhitegray

  • colorMatchstringqueryOpcional

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

    Valores:anyall

  • creatorstring[]queryOpcional

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

  • typestringqueryOpcional

    Only videos sharing a prompt, or a skill.

    Valores:promptskill

  • sortstringqueryOpcional

    By post date. Defaults to newest.

    Valores:newestoldest

  • limitintegerqueryOpcional

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

  • offsetintegerqueryOpcional

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

Exemplo de pedido

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

Respostas

200

The matching videos, without prompts.

Cabeçalhos

  • 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

Corpo da respostaapplication/json

  • totalintegerObrigatório

    Matches before paging.

  • limitintegerObrigatório
  • offsetintegerObrigatório
  • videosVideoSummary[]Obrigatório
    Mostrar campos
    • slugstringObrigatório
    • titlestringObrigatório
    • datestringdateObrigatório
    • tagsstring[]Obrigatório

      Valores:promptskill

    • contentTagsstring[]Obrigatório

      Valores:product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccode

    • promptSharedbooleanObrigatório
    • handlestringObrigatório
    • creatorNamestring
    • avatarstringuriObrigatório
    • posterstringuriObrigatório
    • previewstringuriObrigatório
    • videostringuriObrigatório
    • widthintegerObrigatório
    • heightintegerObrigatório
    • descriptionstring
    • modelstring

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

    • stackstring
    • effortstring

      Valores:mediumhighmax

    • iterationsstring

      Valores:one-shotfew-roundsmany-rounds

    • colorNamesstring[]Obrigatório

      Named colours the video contains.

      Valores:redorangeyellowgreentealbluepurplepinkbrownblackwhitegray

    • pageUrlstringuriObrigatório

      The video's page in English.

  • resolvedobjectObrigatório
    Mostrar campos
    • modelsobject[]Obrigatório

      How each requested model was read, in request order.

      Mostrar campos
      • requestedstringObrigatório

        As sent.

      • matchedstring[]Obrigatório

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

    • creatorsobject[]Obrigatório

      How each requested creator was read, in request order.

      Mostrar campos
      • requestedstringObrigatório

        As sent.

      • matchedstring[]Obrigatório

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

      • similarstring[]Obrigatório

        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.

    Mostrar campos
    • facetstringObrigatório

      Valores:qcategorymodelcolorcreatortype

    • totalintegerObrigatório

Exemplo

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

Corpo da respostaapplication/json

  • errorstringObrigatório

    Valores:invalid_parameter

  • parameterstringObrigatório
  • messagestringObrigatório
  • allowedstring[]

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

Exemplo

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