> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kontext.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Swift Video SDK

> Overlay, pause and linear video ads for short-drama and other video-first iOS apps.

> [card] [Swift Video SDK](https://github.com/kontextso/sdk-swift-video)
>
> A Swift SDK that puts ads into your video player: a strip over the content, a card while it is paused, or a full-screen spot between episodes.

The Video SDK is a separate SDK from the [Swift SDK](https://docs.kontext.so/sdk/swift.md) for chat apps. It speaks the same ad server, but its model is the one video apps know from mobile ad SDKs: ask for an ad, look at its price, load it, show it at the moment you pick, and get one callback when it ends.

## The three formats

> [card] Overlay
>
> A strip across the player while the content plays. Ends by itself after its duration, or when the viewer closes it.

> [card] Pause
>
> A card, or the full player, while the content is paused. Stays until the viewer resumes or you dismiss it.

> [card] Linear
>
> A full-screen video at a moment you choose: between episodes, before a premium one. Skippable when the advertiser allows.

## Requirements

* iOS 14.0+
* Swift 5.9+
* Xcode 15+

> [!NOTE]
>
> You'll need a [publisher account](https://docs.kontext.so/publishers.md#getting-started-is-easy) to obtain your `publisherToken`.

> [card] [Installation](https://docs.kontext.so/video/sdk/swift/installation.md)
>
> Add the package, initialize the SDK, configure ATT and SKAdNetwork.

> [card] [Showing your first ad](https://docs.kontext.so/video/sdk/swift/first-ad.md)
>
> Create the video's ads, get an ad, load it, show it: overlay, pause and linear.

> [card] [API reference](https://docs.kontext.so/video/sdk/swift/api.md)
>
> Every type, method, callback and error.

> [card] [Guides](https://docs.kontext.so/video/sdk/swift/guides.md)
>
> Loading several ads at once, your own auction, no-fill, the playhead, and more.

> [card] [Example app](https://docs.kontext.so/video/sdk/swift/example.md)
>
> A SwiftUI player with all three formats, runnable against your publisher token.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.