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

> Build and run ad campaigns on Thrad — and across ChatGPT — straight from your own code.

The **Thrad Advertiser API** lets you launch and manage ad campaigns programmatically and read back performance that combines **Thrad** and **ChatGPT (OpenAI Ads)** supply — all over a single REST surface. Bare JSON objects and lists, money in integer micros, ISO 8601 timestamps, one Bearer key. See [Conventions](https://docs.thrad.ai/advertisers/overview.md#conventions) for the details that apply across every endpoint.

> [card] [Get your API key](#get-your-api-key)
>
> Two minutes — create an advertiser account and generate your key.

> [card] [Quickstart](https://docs.thrad.ai/advertisers/quickstart.md)
>
> Go from zero to a live campaign with copy-paste cURL.

## Get your API key

Every request is authenticated with a single org-bound Bearer key (`ak_...`). Here's how to create yours.

**1. Create an advertiser account**

Sign up — or sign in — at the [Thrad Platform](https://platform.thrad.ai) and create your advertiser organization. It's the home for your billing, campaigns, and API key.

**2. Open Settings → API keys**

In the dashboard, head to **Settings → API keys**. Key management is available to organization **owners** and **admins**.

**3. Generate your key**

Click **Generate** to mint your key. The full secret (`ak_...`) is shown **once** — copy it immediately and keep it somewhere safe, like the environment variable `THRAD_ADS_API_KEY`.

```bash theme={null}
export THRAD_ADS_API_KEY="ak_your_key_here"
```

> [!NOTE]
>
> There is **one active key per organization**. Rotating issues a new key and keeps the previous one working for a short grace window before it stops; revoking cuts a key off immediately. Treat the key like a password and never commit it to source control.

Confirm it works with a single call — a `200` means you're ready to build:

```bash theme={null}
curl https://api.thrad.ai/v1/ad_account \
  -H "Authorization: Bearer $THRAD_ADS_API_KEY"
```

## What's in these docs

> [card] [Attribution](https://docs.thrad.ai/advertisers/attribution/overview.md)
>
> Measure what your ads actually drive. Drop in the Thrad **tag** or call the **server-side API** to report page views, events, and conversions back to Thrad — and close the loop on performance.

> [card] [Product feeds](https://docs.thrad.ai/advertisers/feeds/overview.md)
>
> Connect your product catalog over SFTP so every item becomes a ready-to-use ad asset — and let stock status pause and resume delivery automatically.

> [card] [Advertiser API](https://docs.thrad.ai/advertisers/overview.md)
>
> The campaign engine. Create the full campaign tree, launch it, run its lifecycle, and read combined Thrad + ChatGPT insights — plus the base URL, resource hierarchy, and conventions.

> [card] [API Reference](https://docs.thrad.ai/advertisers/api-reference/authentication.md)
>
> Every endpoint in detail — authentication, targeting, campaigns, ad groups, ads, assets, the ad account, and insights — with full request and response schemas.

## Ready to build?

> [card] [Start the Quickstart](https://docs.thrad.ai/advertisers/quickstart.md)
>
> Create a key, pick a creative asset, launch your first campaign in one nested call, and read its performance — end to end, with copy-paste cURL and Python.


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