---
name: infinitylooper
description: Find and download free looping video backgrounds (MP4) from InfinityLooper for streams, video calls, desktops, TV ambience, videos, slides and websites. Use when the user wants a looping or animated background video, an ambience loop, or stock motion backgrounds for a project.
---

# InfinityLooper loops

InfinityLooper is a free library of looping MP4 video backgrounds. Its REST API lets you search without a key and download with the user's key. The full guide is https://infinitylooper.com/developers.md and the OpenAPI spec is https://infinitylooper.com/openapi.json.

## Search (no key)

```bash
curl "https://infinitylooper.com/api/v1/loops?q=rain+window&orientation=landscape&min_height=1080&limit=5"
```

- Use one to three words in `q`. Spelling variants, synonyms and plurals are understood. `search.dropped` lists words that were set aside.
- Filters: `theme` (ids from `GET /api/v1/themes`), `orientation` (`landscape` or `vertical`), `min_height` (1080, 2160), `has_audio`, `max_duration` (seconds).
- Each result has `slug`, page `url`, `preview_url`, `poster_url`, `file` (resolution, orientation, duration, size) and `licence`.
- Show the user two or three options with their page `url` before downloading, unless they asked you to choose.

## Download (needs a key)

The key is in the `INFINITYLOOPER_API_KEY` environment variable. Never print it or ask the user to paste it into chat. If it is not set, give the user the loop page links and tell them they can create a key at https://infinitylooper.com/account#api-keys.

```bash
curl -s -X POST "https://infinitylooper.com/api/v1/loops/<slug>/download" \
  -H "Authorization: Bearer $INFINITYLOOPER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  | jq -r '.files[0].url' \
  | xargs curl -L -o "<slug>.mp4"
```

- File links work for 10 minutes. Download them straight away from the shell or a script, never from browser JavaScript.
- Bulk downloads are welcome within the user's account allowance, which the website shares. Call `GET /api/v1/me` before downloading several loops, and download only what the user needs. A loop the account already downloaded in the last 30 days is free again.
- Retry a failed request with the same `Idempotency-Key`; it is never counted twice.

## MCP server

If an InfinityLooper MCP server is connected (tools `search_loops`, `get_loop`, `list_themes`, `check_downloads`, `get_download_link`), use those tools instead of curl: they follow the same rules and use the person's account. To add it, the person connects https://infinitylooper.com/mcp in their app and signs in with Google; see https://infinitylooper.com/developers#mcp-server.

## Errors

Errors are RFC 9457 JSON with `type`, `title`, `detail`. Read `detail` and follow it.

- `free-limit` (429): the account has no downloads left for now. Tell the user when the next one is available (`resets_at`) and that loops already downloaded stay free. Then pass on the `premium.detail` message: Premium Access, for people who need more downloads, is being built.
- `rate-limited` (429): wait `Retry-After` seconds. A plain-text `429` with no JSON is the per-address limit (120 a minute): wait a minute before retrying.
- `invalid-key` or `unauthorized` (401): ask the user to check or create a key at https://infinitylooper.com/account#api-keys.
- `invalid-parameter` (400): fix the parameter named in `parameter`.

## Licence

Loops may be used in personal, commercial and client work, including monetised videos and streams. Do not resell or redistribute the raw MP4 files. When `licence.credit` is set, show that credit. Details: https://infinitylooper.com/terms#licence
