Skip to content

Reference

Technical reference for the three Advertising.chat APIs, the event stream behind reporting, and the vocabulary shared across the platform.

APIs

Advertising.chat exposes three purpose-named APIs, one per product:

  • Ad Fetch API — the public dataplane at ads.advertising.chat/v1/* (fetch, event, click). API-key auth with a per-application fetch key. This is the only API in-chat publishers need.
  • Offer Manager API — enterprise management at api.advertising.chat/system/offer-manager/* for defining and targeting your own ad units, line items, and creatives.
  • Campaign Management API — advertiser management at api.advertising.chat/system/campaigns/* for campaigns, ad groups, and creatives run across the network.

Events and vocabulary

  • Ad Events — the event stream behind reporting: fetches, message lifecycle notifications, clicks, and conversions, plus the APIs for reporting events and tracking conversions.
  • Concepts & Glossary — the platform vocabulary (ad unit, line item, creative, campaign) and how it maps to the enterprise Offer Manager names.