KeepFace

Keepface Affiliate API v2

The public server-side affiliate tracking API for Keepface. Brands POST sale and refund events from their own backend (or from Shopify, or from the browser JS pixel) and Keepface attributes them to the creator whose link or discount code drove the sale. Every write is HMAC-SHA256 signed with a per-brand secret over a timestamped payload, replay-protected at a 300 second tolerance, and idempotent on (brand_id, order_id). A public click-resolve endpoint turns a short affiliate token into a destination URL, cookie window and campaign status. Rate limits and Retry-After are published per endpoint, and the API returns X-RateLimit-Limit / X-RateLimit-Remaining on live responses.

GitHub

Documentation

📖
APIReference
https://help.keepface.com/brand/affiliate-program/api-reference/
📖
Documentation
https://help.keepface.com/brand/affiliate-program/postback-hmac-integration/
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/keepface/refs/heads/main/rate-limits/keepface-rate-limits.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/keepface/refs/heads/main/asyncapi/keepface-affiliate-webhooks.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/keepface/refs/heads/main/errors/keepface-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/keepface/refs/heads/main/data-model/keepface-data-model.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/keepface/refs/heads/main/apis.yml

API entry from apis.yml

apis.yml Raw ↑ 
aid: keepface:affiliate
name: Keepface Affiliate API v2
description: The public server-side affiliate tracking API for Keepface. Brands POST sale and refund events
  from their own backend (or from Shopify, or from the browser JS pixel) and Keepface attributes them
  to the creator whose link or discount code drove the sale. Every write is HMAC-SHA256 signed with a
  per-brand secret over a timestamped payload, replay-protected at a 300 second tolerance, and idempotent
  on (brand_id, order_id). A public click-resolve endpoint turns a short affiliate token into a destination
  URL, cookie window and campaign status. Rate limits and Retry-After are published per endpoint, and
  the API returns X-RateLimit-Limit / X-RateLimit-Remaining on live responses.
humanURL: https://help.keepface.com/brand/affiliate-program/api-reference/
baseURL: https://api.keepface.ai/api/v2
tags:
- Affiliate Marketing
- Attribution
- Webhooks
- Conversion Tracking
properties:
- type: APIReference
  url: https://help.keepface.com/brand/affiliate-program/api-reference/
- type: Documentation
  url: https://help.keepface.com/brand/affiliate-program/postback-hmac-integration/
- type: Webhooks
  url: asyncapi/keepface-affiliate-webhooks.yml
- type: ErrorCatalog
  url: errors/keepface-problem-types.yml
- type: RateLimits
  url: rate-limits/keepface-rate-limits.yml
- type: DataModel
  url: data-model/keepface-data-model.yml