Search MotionVideo

Search videos, creators, tools, creatives…

Get a video

One gallery video with its prompt or skill, its category, the videos before and after it in that category, and the five most similar videos.

GEThttps://motionvideo.xyz/api/catalog/videos/{slug}

Parameters

  • slugstringpathRequired

    The video's slug.

Example request

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

Responses

200

The video.

Headers

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

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

Response bodyapplication/json

    Example

    {
      "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",
      "prompt": "string",
      "skillUrl": "http://example.com",
      "skillInstall": "string",
      "tweetUrl": "http://example.com",
      "colors": [
        "string"
      ],
      "category": "product-ui",
      "categoryUrl": "http://example.com",
      "neighbours": {
        "previous": "string",
        "next": "string"
      },
      "similar": [
        {
          "slug": "string",
          "title": "string"
        }
      ]
    }

    400

    A parameter is unknown or has a value it can't take.

    Response bodyapplication/json

    • errorstringRequired

      Values:invalid_parameter

    • parameterstringRequired
    • messagestringRequired
    • allowedstring[]

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

    Example

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

    404

    No video with that slug. Names the video it duplicated when it was removed as a duplicate, and suggests the creator's other videos.

    Response bodyapplication/json

    • errorstringRequired

      Values:not_found

    • messagestringRequired
    • duplicateOfstring

      When the slug was removed as a duplicate: the video it duplicated.

    • suggestionsVideoRef[]Required

      Up to five videos by the same creator.

      Show fields
      • slugstringRequired
      • titlestringRequired

    Example

    {
      "error": "not_found",
      "message": "string",
      "duplicateOf": "string",
      "suggestions": [
        {
          "slug": "string",
          "title": "string"
        }
      ]
    }