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"
  }
}

Endpoints

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.

isActivation

boolean | null

Whether these impressions are for an activation offer flow

Response

Impressions recorded successfully (no content returned)

Get ZeroClick offers