This article will cover the following:
When to use these endpoints:
Use these endpoints for server-side conversion recording without a browser pixel, reconciliation against advertiser data, and auditing click-to-conversion attribution chains.
Use these endpoints for server-side conversion recording without a browser pixel, reconciliation against advertiser data, and auditing click-to-conversion attribution chains.
Authentication: All CAKE API requests require your
api_key parameter. Find yours under Setup → System Access → API Keys.Part of a series: This focused guide covers specific endpoints from the complete CAKE API — Tracking & Conversions reference, which documents all available endpoints for this feature area.
Available Endpoints
Get Click
Retrieves click records. Look up a specific click by click_id or pull filtered lists for reporting, troubleshooting attribution, or verifying a click was recorded before a conversion was fired.
When to use: Troubleshoot a missing conversion — confirm the click was recorded before investigating the conversion pipeline.
GET /api/2/click.json| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your CAKE API key. |
| click_id | string | No | Unique CAKE click identifier. Returns single record; takes priority over date filters. |
| start_date | date | No | Start of date range (YYYY-MM-DD). |
| end_date | date | No | End of date range (YYYY-MM-DD). |
| offer_id | integer | No | Filter by offer ID. |
| affiliate_id | integer | No | Filter by affiliate ID. |
| start_at_row | integer | No | Pagination offset. Default 0. |
| row_limit | integer | No | Max records. Default 100, max 10000. |
Sample request
GET https://yourdomain.cakemarketing.com/api/2/click.json?api_key=YOUR_API_KEY&start_date=2026-01-01&end_date=2026-01-31&offer_id=12345&affiliate_id=67890&start_at_row=0&row_limit=50Sample response
{
"request_status": "Success",
"response": {
"clicks": [
{
"click_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"click_date": "2026-01-15 09:42:11",
"offer_id": 12345,
"affiliate_id": 67890,
"sub_id_1": "banner_300x250",
"ip_address": "203.0.113.42",
"country": "US",
"converted": true,
"conversion_id": 998877
}
],
"total_rows": 1
}
}Record Conversion
Records a conversion event against a previously tracked click. This is the server-side method, called by an advertiser's backend on their confirmation page. CAKE validates the click, applies payout rules, and triggers affiliate postbacks.
When to use: Fire a server-side conversion without a browser pixel — the most reliable method when an advertiser confirms a completed action server-side.
GET /api/2/conversion.json| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your CAKE API key. |
| click_id | string | Yes | The CAKE click ID (reqsessid) captured at click time. |
| offer_id | integer | Yes | The offer ID the conversion belongs to. |
| payout | decimal | No | Override affiliate payout for this conversion. |
| revenue | decimal | No | Override advertiser revenue for this conversion. |
| conversion_date | datetime | No | Date of conversion (YYYY-MM-DD HH:MM:SS). Defaults to now. |
| unique_id | string | No | Your internal transaction ID for deduplication. |
| order_id | string | No | Advertiser order reference. |
| adv1 | string | No | Custom advertiser data field 1. |
| adv2 | string | No | Custom advertiser data field 2. |
| adv3 | string | No | Custom advertiser data field 3. |
| adv4 | string | No | Custom advertiser data field 4. |
| adv5 | string | No | Custom advertiser data field 5. |
Sample request
GET https://yourdomain.cakemarketing.com/api/2/conversion.json?api_key=YOUR_API_KEY&click_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890&offer_id=12345&payout=18.00&revenue=22.00&unique_id=ORD-98765Sample response
{
"request_status": "Success",
"conversion": {
"conversion_id": 998877,
"offer_id": 12345,
"affiliate_id": 67890,
"click_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"payout": 18.00,
"revenue": 22.00,
"unique_id": "ORD-98765",
"conversion_date": "2026-06-19 14:30:00",
"conversion_status": "approved"
}
}Get Conversions
Pull conversion records for a date range, offer, or affiliate — use for reconciliation, external dashboards, or auditing payout accuracy before billing.
When to use: Reconcile CAKE conversions against advertiser reports; audit payout accuracy before generating invoices.
GET /api/2/conversions.json| Parameter | Type | Required | Description |
|---|---|---|---|
| api_key | string | Yes | Your CAKE API key. |
| start_date | date | Yes | Start of date range (YYYY-MM-DD). |
| end_date | date | Yes | End of date range (YYYY-MM-DD). |
| offer_id | integer | No | Filter by offer. |
| affiliate_id | integer | No | Filter by affiliate. |
| advertiser_id | integer | No | Filter by advertiser. |
| conversion_status | string | No | approved | pending | rejected | reversed |
| start_at_row | integer | No | Pagination offset. |
| row_limit | integer | No | Max records. Default 100, max 500. |
| sort_field | string | No | Field to sort by. |
| sort_descending | boolean | No | true for descending. |
Sample request
GET https://yourdomain.cakemarketing.com/api/2/conversions.json?api_key=YOUR_API_KEY&start_date=2026-06-01&end_date=2026-06-19&offer_id=12345&conversion_status=approved&row_limit=50Sample response
{
"request_status": "Success",
"total_rows": 1,
"conversions": [
{
"conversion": {
"conversion_id": 998877,
"offer": { "offer_id": 12345, "offer_name": "Auto Insurance Quote" },
"affiliate": { "affiliate_id": 67890, "affiliate_name": "MediaBridge Partners" },
"payout": 18.00,
"revenue": 22.00,
"conversion_status": "approved",
"conversion_date": "2026-06-19 14:30:00"
}
}
]
}You may also be interested in:
If you have any questions, please reach out to your dedicated CAKE Client Success Manager/Account Manager or contact the CAKE Support Team at support@getCAKE.com.