Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.zeroclick.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

ZeroClick returns rich, structured offer data — you decide how it looks. Build ad UI that matches the look and feel of your product using the fields available in each offer response.
Browse production-ready reference implementations for chat, IDE, and CLI surfaces in the ZeroClick Ad Format Gallery.

​
Offer Data Structure

Each offer includes structured fields for building custom UI:
FieldTypeDescription
titlestring | nullMain headline
subtitlestring | nullBrief description or tagline
contentstring | nullDetailed offer copy
ctastring | nullCall-to-action text (e.g., “Shop Now”)
clickUrlstringDestination URL — always present
imageUrlstring | nullOffer or product image
brandobject | nullBrand name, icon, URL, and description
productobject | nullProduct details (title, category, image, availability)
priceobject | nullPrice amount and currency
ratingobject | nullRating value, scale, and review count
Fields marked as nullable are not guaranteed on every response. Advertisers provide varying levels of detail — always use optional chaining and fallback values.

​
Example

const renderOffer = (offer) => {
  const card = `
    <div class="offer-card">
      ${offer.imageUrl ? `<img src="${offer.imageUrl}" alt="${offer.title || 'Offer'}" />` : ''}
      <h3>${offer.title || 'Featured Offer'}</h3>
      ${offer.subtitle ? `<p class="subtitle">${offer.subtitle}</p>` : ''}
      ${offer.content ? `<p>${offer.content}</p>` : ''}
      <a href="${offer.clickUrl}" target="_blank">${offer.cta || 'Learn More'}</a>
      ${offer.price ? `<span class="price">${offer.price.currency} ${offer.price.amount}</span>` : ''}
    </div>
  `;
  return card;
};

​
Best Practices

  • Handle nullable fields gracefully. Use optional chaining and fallback values — offer.cta || 'Learn More', offer.imageUrl || offer.brand?.iconUrl, etc. Not every advertiser provides every field.
  • Use clickUrl for all offer links. This is the only field guaranteed on every offer and includes built-in click tracking.
  • Match your product’s look and feel. Offers perform best when they feel native to the surface — match typography, spacing, and layout patterns your users already expect.
  • Show brand context when available. Displaying brand.name and brand.iconUrl alongside the offer builds trust and improves click-through rates.

​
Next Steps

Ad Format Gallery

Interactive reference implementations

REST API

Fetch offers to render

Track Impressions

Record displayed offers