Track offer impressions

curl --request POST \
  --url https://zeroclick.dev/api/v2/impressions \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f23456789012"
  ]
}
'

{
  "error": {
    "message": "Too many requests to this resource"
  }
}

Tracking

Track offer impressions

⚠️ Critical: This endpoint MUST be called from client devices. Requests will be rate limited per IP. See https://docs.zeroclick.ai/rate-limiting#ip-based-rate-limiting for details.

Records that offers were displayed to the user. Call this endpoint when offers are rendered/visible to the user.

Important: This endpoint does not require authentication and supports CORS for cross-origin requests.

Response: Returns 204 No Content immediately. Processing happens asynchronously.

POST

api

impressions

Track offer impressions

curl --request POST \
  --url https://zeroclick.dev/api/v2/impressions \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6a7-8901-bcde-f23456789012"
  ]
}
'

{
  "error": {
    "message": "Too many requests to this resource"
  }
}

Body

application/json

ids

string[]

required

Array of offer IDs that were displayed to the user. These are the "id" values from the offers response.

Response

Impressions recorded successfully (no content returned)

Get ZeroClick offers

Offers

REST API

Endpoints

Track offer impressions

Body

Response