Offers
Learn about the different ways to fetch and display ads from the AIARCO Ads API.
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:
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.
Drop-in script tag for websites and single-page apps. Handles fetching, rendering, and impression tracking automatically.
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