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

> **[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

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

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

> **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`.

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

> **[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.

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

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

> **[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.