Public API

Read-only JSON endpoints for the catalog, directories and moves.

Read-only JSON over HTTPS from https://motionvideo.xyz. The endpoints need no key or sign-in. Move prompts are part of Pro: the Pro MCP tools return them when you sign in with a Pro or Business account.

The whole API is described in an OpenAPI 3.1 document at /openapi.json. Load it into an API client or a code generator.

Endpoints

Get the catalogGET /api/catalog: every gallery video with its prompt, model, stack, effort and media URLs.Get the directoriesGET /api/catalog/directories: the tools, skills, extras and creatives directories.Get the movesGET /api/moves: the public part of every move. No prompts.

Two plain-text files sit next to them:

File	Returns
`GET /llms.txt`	A plain-text map of the public site for LLM agents.
`GET /skill.md`	An agent skill that tells a coding agent how to use MotionVideo.

Terminal

curl https://motionvideo.xyz/api/catalog
curl https://motionvideo.xyz/api/moves

Caching

Every JSON response carries an ETag: a quoted hash of the body. Send it back in If-None-Match and you get an empty 304 Not Modified while nothing changed.

Only download the catalog when it changed:

Terminal

curl -i https://motionvideo.xyz/api/catalog -H 'If-None-Match: "<etag>"'

Send the value exactly as you got it. Lists of ETags, weak W/ validators and * always get the full response.

Responses send Cache-Control: public, max-age=300, s-maxage=3600, stale-while-revalidate=86400: a browser may reuse a response for 5 minutes and a shared cache for an hour, so through a cache, new data can take that long to show up.

From a browser

The endpoints don't send CORS headers, so a web page on another origin can't read them. Call them from a server, a script or an agent.