Get Clicks | Captain Docs

import json
import requests
BASE_URL = "https://acme.captain.dev"
API_KEY = "your_search_key"
INDEX = "products"
headers = {
    "Authorization": f"Bearer {API_KEY}",
}
response = requests.get(
    f"{BASE_URL}/v1/indexes/{INDEX}/analytics/clicks",
    headers=headers,
    params={"start_date": "2026-09-22", "end_date": "2026-09-28"},
    timeout=30.0,
)
print(json.dumps(response.json(), indent=2))

{
  "start_date": "2026-09-22",
  "end_date": "2026-09-28",
  "rate": 0.3842,
  "click_count": 3656,
  "tracked_search_count": 9517,
  "average_position": 2.34,
  "positions": [
    {
      "position": [
        1,
        1
      ],
      "click_count": 2100
    },
    {
      "position": [
        2,
        2
      ],
      "click_count": 700
    },
    {
      "position": [
        3,
        3
      ],
      "click_count": 400
    },
    {
      "position": [
        4,
        4
      ],
      "click_count": 250
    },
    {
      "position": [
        5,
        5
      ],
      "click_count": 160
    },
    {
      "position": [
        6,
        6
      ],
      "click_count": 100
    },
    {
      "position": [
        7,
        7
      ],
      "click_count": 70
    },
    {
      "position": [
        8,
        8
      ],
      "click_count": 50
    },
    {
      "position": [
        9,
        9
      ],
      "click_count": 30
    },
    {
      "position": [
        10,
        10
      ],
      "click_count": 20
    },
    {
      "position": [
        11,
        20
      ],
      "click_count": 30
    },
    {
      "position": [
        21,
        -1
      ],
      "click_count": 10
    }
  ],
  "dates": [
    {
      "date": "2026-09-22",
      "rate": 0.3799
    },
    {
      "date": "2026-09-23",
      "rate": 0.3878
    },
    {
      "date": "2026-09-24",
      "rate": 0.3813
    },
    {
      "date": "2026-09-25",
      "rate": 0.391
    },
    {
      "date": "2026-09-26",
      "rate": 0.3825
    },
    {
      "date": "2026-09-27",
      "rate": 0.386
    },
    {
      "date": "2026-09-28",
      "rate": 0.3811
    }
  ]
}

Get the click-through rate in total and per day, the average click position, and clicks per position.

Authentication

AuthorizationBearer

A search key, issued by Captain. Sent as Authorization: Bearer <key>.

Path parameters

indexstringRequiredformat: "^[a-z0-9][a-z0-9_-]{0,47}$"

index name

Query parameters

start_datestringOptionalformat: "date"

first day, UTC, inclusive (YYYY-MM-DD). Default: 6 days before end_date (a 7-day window)

end_datestringOptionalformat: "date"

last day, UTC, inclusive (YYYY-MM-DD). Default: today. At most 366 days from start_date

Response

report

start_datestringformat: "date"

end_datestringformat: "date"

ratedouble or null

click-through rate: click_count / tracked_search_count

click_countinteger

tracked searches with at least one click

tracked_search_countinteger

average_positiondouble or null

mean position (1-based) of the clicks on tracked searches, two decimals; null with no clicks

positionslist of objects

12 buckets: positions 1 through 10 each, then 11-20, then 21 and beyond

dateslist of objects

every day of the window, oldest first; rate is null on a day with nothing to divide by