List advertiser click totals for a date range

Operation

GET /clicks

Returns daily click aggregates (one row per advertiser per click_date) for a required inclusive date window up to 90 days. Searchkick-backed when the cluster is healthy, with automatic SQL fallback when Searchkick is unavailable or search execution fails. Non-admin callers are scoped to advertisers visible through their publisher; admins may omit publisher_id for all publishers or pass publisher_id to filter one publisher.

Parameters

Request Body

No request body is defined for this operation.

Responses

{
  "description": "Click rows ordered by click_date desc, click_count desc, advertiser_id asc.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Click"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ClicksListMeta"
          }
        },
        "required": [
          "data",
          "meta"
        ]
      }
    }
  }
}

{
  "$ref": "#/components/responses/BadRequest"
}

{
  "$ref": "#/components/responses/Unauthorized"
}

{
  "$ref": "#/components/responses/Forbidden"
}

API Playground

Run this GET request with your API key, or open it in a new tab. Path uses sample IDs where the OpenAPI path has {parameters}. Sign in to enable live testing with your API key.