List Game Videos

`GET /game-videos`

Returns a paginated list of available gameplay video overlays. These are used as split-screen overlays — the gameplay footage plays in the bottom half of the short while your main content plays in the top half.

This is a popular format on TikTok and Instagram Reels, commonly used with podcast clips, educational content, and commentary videos to boost watch time and engagement.

Available game videos

Hover over any video to see a live preview.

Query parameters

Parameter	Type	Default	Description
`page`	number	`1`	Page number (starting from 1)
`limit`	number	`20`	Items per page (1–100)

Request

curl -H "X-API-Key: sk_ssemble_your_key" \
  "https://aiclipping.ssemble.com/api/v1/game-videos?page=1&limit=20"

Response

{
  "data": {
    "gameVideos": [
      {
        "name": "GTA",
        "preview": "https://cf.ssemble.com/ssemble-static-assets/GTA_2mins_preview.jpg"
      },
      {
        "name": "Minecraft",
        "preview": "https://cf.ssemble.com/ssemble-static-assets/Minecraft_2mins_preview.jpg"
      },
      {
        "name": "SubwaySurfer",
        "preview": "https://cf.ssemble.com/ssemble-static-assets/SubwaySurfer_2mins_preview.jpg"
      },
      {
        "name": "fortnite",
        "preview": "https://cf.ssemble.com/ssemble-static-assets/fortnite_preview.jpg"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalPages": 2,
      "totalCount": 30
    }
  }
}

Response fields

Game video object

Field	Type	Description
`name`	string	Game video name. Use this exact value as `gameVideoName` in `POST /shorts/create`.
`preview`	string	URL to a preview image showing the gameplay footage

Pagination object

Field	Type	Description
`page`	number	Current page number
`limit`	number	Items per page
`totalPages`	number	Total pages available
`totalCount`	number	Total number of game videos

How split-screen overlays work

When you enable a game video overlay, the generated short is split vertically:

Top half — Your main video content (podcast, commentary, educational content)
Bottom half — The selected gameplay footage playing on loop

The gameplay footage is automatically trimmed, looped, and synced to match the duration of your short. The original video audio is preserved — only the visual is split.

┌─────────────────────┐
│                     │
│   Your Content      │
│   (top half)        │
│                     │
├─────────────────────┤
│                     │
│   Gameplay Video    │
│   (bottom half)     │
│                     │
└─────────────────────┘

Using game video overlays

With a specific game video

{
  "url": "https://www.youtube.com/watch?v=...",
  "start": 0,
  "end": 600,
  "gameVideo": true,
  "gameVideoName": "Minecraft"
}

With a random game video

If gameVideoName is omitted, a random video from the library is selected:

{
  "url": "https://www.youtube.com/watch?v=...",
  "start": 0,
  "end": 600,
  "gameVideo": true
}

Combining with other overlays

Game video overlays can be combined with other features:

{
  "url": "https://www.youtube.com/watch?v=...",
  "start": 0,
  "end": 600,
  "gameVideo": true,
  "gameVideoName": "SubwaySurfer",
  "music": true,
  "musicName": "Energetic Beat",
  "musicVolume": 10,
  "hookTitle": true
}

Note that game video overlays change the layout — the main video occupies only the top half. The layout parameter (fill, fit, square) is applied to the top half content.

Error responses

Status	Code	When
400	`invalid_request`	Invalid pagination parameters
401	`invalid_api_key`	Missing or invalid API key
429	`rate_limit_exceeded`	Too many requests

Notes

The game video library is curated by Ssemble and may be updated over time.
Game video names are case-sensitive when used in POST /shorts/create.
If a gameVideoName doesn't match any video in the library, the API returns a 400 error with code invalid_request.
Game video overlays work best with talking-head, podcast, and commentary-style content where the speaker's face is in the upper portion of the frame.

On this page