MotionVideoを検索

動画、クリエイター、ツール、クリエイティブを検索…

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

パラメーター

  • qstringquery任意

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

  • categorystring[]query任意

    Gallery categories, any of them.

    値:product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccode

  • modelstring[]query任意

    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[]query任意

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

    値:redorangeyellowgreentealbluepurplepinkbrownblackwhitegray

  • colorMatchstringquery任意

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

    値:anyall

  • creatorstring[]query任意

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

  • typestringquery任意

    Only videos sharing a prompt, or a skill.

    値:promptskill

  • sortstringquery任意

    By post date. Defaults to newest.

    値:newestoldest

  • limitintegerquery任意

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

  • offsetintegerquery任意

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

リクエスト例

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

レスポンス

200

The matching videos, without prompts.

ヘッダー

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

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

レスポンスボディapplication/json

  • totalinteger必須

    Matches before paging.

  • limitinteger必須
  • offsetinteger必須
  • videosVideoSummary[]必須
    フィールドを表示
    • slugstring必須
    • titlestring必須
    • datestringdate必須
    • tagsstring[]必須

      値:promptskill

    • contentTagsstring[]必須

      値:product-uiphonechartsdiagramskinetic-typeshapesparticlescharactersphotosmusiccode

    • promptSharedboolean必須
    • handlestring必須
    • creatorNamestring
    • avatarstringuri必須
    • posterstringuri必須
    • previewstringuri必須
    • videostringuri必須
    • widthinteger必須
    • heightinteger必須
    • descriptionstring
    • modelstring

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

    • stackstring
    • effortstring

      値:mediumhighmax

    • iterationsstring

      値:one-shotfew-roundsmany-rounds

    • colorNamesstring[]必須

      Named colours the video contains.

      値:redorangeyellowgreentealbluepurplepinkbrownblackwhitegray

    • pageUrlstringuri必須

      The video's page in English.

  • resolvedobject必須
    フィールドを表示
    • modelsobject[]必須

      How each requested model was read, in request order.

      フィールドを表示
      • requestedstring必須

        As sent.

      • matchedstring[]必須

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

    • creatorsobject[]必須

      How each requested creator was read, in request order.

      フィールドを表示
      • requestedstring必須

        As sent.

      • matchedstring[]必須

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

      • similarstring[]必須

        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.

    フィールドを表示
    • facetstring必須

      値:qcategorymodelcolorcreatortype

    • totalinteger必須

例

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

レスポンスボディapplication/json

  • errorstring必須

    値:invalid_parameter

  • parameterstring必須
  • messagestring必須
  • allowedstring[]

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

例

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