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

# Introduction

> For publishers: what Thrad does, and how to go from sign-up to live ads.

Thrad lets you earn revenue by showing native ads inside your AI chat app.

1. **You ask for an ad.** Your backend sends a [bid request](https://docs.thrad.ai/api/api-reference/bid-request-v2.md) with the conversation context and the user's device. Always include the user's country (`device.geo.country`), device type and OS: campaigns target them.
2. **Advertisers bid.** Thrad runs an auction and returns the best-matching ad, or none.
3. **You show it.** You draw the ad in your own UI as a card, carousel or poll. See [Ad Formats & Rendering](https://docs.thrad.ai/api/guides/rendering-v2.md).
4. **You get paid.** Each ad carries tracking links. You fire them from the user's device, once the ad is actually on screen. You're paid for those viewable impressions. See [Impression Billing](https://docs.thrad.ai/api/guides/billing-viewability.md).

Ads come back as plain JSON, with no scripts or iframes, so you keep full control of how they look.

## From sign-up to live ads

**1. Talk to us**

Access is limited to approved partners. Email **[contact@thrad.ai](mailto:contact@thrad.ai)** with a link to your app and a note on your audience. We'll set up a call, and once you're approved we whitelist your account.

**2. Sign up as a publisher**

Create your account on the [Thrad Platform](https://platform.thrad.ai/signup?role=pub) with the email we whitelisted.

**3. Get your staging key**

Create a publisher in the platform, one per app. You'll get a **staging API key** to build and test with.

**4. Build your integration**

Follow the [Quickstart](https://docs.thrad.ai/quickstart.md) to get your first ad on screen.

**5. Go live**

Get your **production API key** and add Thrad to your `ads.txt`. See [Go live](https://docs.thrad.ai/go-live.md).

## Next steps

> [card] [Quickstart](https://docs.thrad.ai/quickstart.md)
>
> Your first ad on screen with the staging key: request, show, count.

> [card] [Agent skills](https://docs.thrad.ai/agent-skills.md)
>
> Building with a coding agent? Give it a Thrad skill and it wires up the integration for you.

Need exact fields? The [API Reference](https://docs.thrad.ai/api/api-reference/bid-request-v2.md) has every request and response.


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