Offer Recommendation Object

Offer Recommendation Object

An offer a publication has joined. The full directory offer is always inlined as offer.

Field	Type	Description
uuid	String	Offer recommendation UUID.
status	String	Status of the joined offer.
created_at	String	When the offer was joined (ISO 8601).
offer	Object	The joined offer (Directory Offer Object).
stats	Object	Performance. Present only with expand=stats.

stats (only with expand=stats)

Field	Type	Description
impressions	Integer	Times shown.
claims	Integer	Primary conversions (claims).
claim_rate	Number	Claims / impressions, as a percentage.
conversions	Integer	Confirmed conversions.
conversion_rate	Number	Confirmed conversions / subscriptions, as a percentage.
earnings	Number	Confirmed earnings, in dollars.

Example (expand=stats)

{
  "uuid": "offrec_5d6e7f",
  "status": "active",
  "created_at": "2026-01-15T09:00:00.000Z",
  "offer": {
    "uuid": "offer_1a2b3c",
    "headline": "Get 20% off Acme Pro",
    "description": "Premium productivity tools for newsletter teams.",
    "terms": "New customers only.",
    "conversion_type": "lead",
    "category": "Productivity",
    "image_url": "https://assets.sparkloop.app/offers/offer_1a2b3c.png",
    "commissions": [ { "type": "fixed_amount", "amount": 2.0, "description": "Per verified lead" } ],
    "geo_restrictions": { "allow_worldwide_referrals": true, "allowed_countries": [], "blocked_countries": [] },
    "source": "external-brand",
    "brand": { "name": "Acme Inc.", "logo_url": "https://assets.sparkloop.app/brands/acme.png" },
    "max_payout": 1000.0
  },
  "stats": {
    "impressions": 4200,
    "claims": 330,
    "claim_rate": 7.86,
    "conversions": 90,
    "conversion_rate": 27.27,
    "earnings": 180.0
  }
}