---
title: "Ad Request"
slug: "broadcast-ad-request"
updated: 2026-08-24T16:29:27Z
published: 2026-08-24T16:29:27Z
canonical: "help.tritondigital.com/broadcast-ad-request"
---

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

# Ad Request

## HTTP Endpoint

The Broadcast Ad-Request Service is available over a public HTTP/HTTPS endpoint:

`//<broadcast-ad-server-host>/broadcast/ars?<query parameters>`

Please contact [Triton Digital Customer Support](/user/docs/contact-support) to obtain the correct host name to use for pre-production and production uses.

A complete example, using many of the available parameters, would look like this:

`https://broadcast.live.streamtheworld.com/broadcast/ars?stid=12345&qty=35800&qtysourceid=1&qtysource=Nielsen`

## Parameters

This section describes the available query string parameters when using the Broadcast Ad-Request Service.

There are two types of request, as described below.

#### Auction request:

This is done when an auction should be executed on the exchange. Triton automatically selects PMP (Private Marketplace) deals that apply. Specific ad categories that can’t be played should be provided on the call to avoid Triton from returning an ad that will be dropped due to industry separation. This request is triggered **when no deal ID** is provided.

#### PG request:

This is done when a [Programmatic Guaranteed (PG) deal](/user/docs/programmatic-guaranteed-pg-deals) is about to air. Triton reaches out to the proper demand partner (and only that partner) for the deal. This request is triggered **when a deal ID** is provided.

> [!WARNING]
> You should only send a query parameter if you specifically want to pass a value for that parameter. *If you do not want to pass a value, do not send the query parameter.*

Parameters should be provided in the **query string of the endpoint URI**.

| Name | Description | Format |
| --- | --- | --- |
| **stid** | **Triton ID** of the placement station. This parameter is **required**. | Integer |
| **ext2_stid** | **External ID** of the station. This parameter is required if `stid` is not provided. | String |
| **deal-id** | ID of an existing PG deal for which the ad is requested. If provided, the request will be limited to the DSP and buyer specified in the deal. If not provided, the request triggers an auction. | String |
| **excluded-iab-categories** | List of ad categories NOT allowed for the requested ad. The current taxonomy used is the [IAB Content Taxonomy v1](https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%201.0.tsv). | Comma-separated list of codes (strings). |