Offers are contextually matched ads returned by the AIARCO API. Each offer includes a title, content, CTA, click URL, and optional rich fields like brand, price, and rating.

​
Integration Methods

Choose the method that fits your architecture:

REST API

Full server-side integration. Make HTTP requests from any language — Python, Node.js, Go, Ruby, etc. Best for backends and AI pipelines where you control the rendering.

JavaScript SDK

Drop-in script tag for websites and single-page apps. Handles fetching, rendering, and impression tracking automatically.

Woven Offers (LLM-Native)

Inject offer data into LLM system prompts. The model naturally weaves relevant ads into its response. Best for chatbots and AI assistants.

​
Offer Response Schema

All methods return offers in the same format. See Rendering Offers for the complete data structure reference. 
{
  "id": "uuid",
  "title": "Ad headline",
  "content": "Ad description",
  "cta": "Shop Now",
  "clickUrl": "https://ads-api.aiarco.com/api/v1/clicks/{id}",
  "source": "aiarco",
  "ad_type": "sponsored_result",
  "brand": { "name": "...", "iconUrl": "..." },
  "price": { "amount": 29.99, "currency": "USD" },
  "rating": { "value": 4, "scale": 5, "count": 120 }
}
Do not cache offer responses. Each response creates impression records with unique IDs. Caching breaks impression tracking, attribution, and revenue reporting.

​
Authentication

All offer requests require a channel API key sent in the X-AIARCO-API-Key header. Get your key from the publisher dashboard under Channels. 
X-AIARCO-API-Key: aiarco_YOUR_CHANNEL_KEY