List No-Click Searches

GET

https://acme.captain.dev/v1/indexes/:index/analytics/searches/no-clicks

GET

/v1/indexes/:index/analytics/searches/no-clicks

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/searches/no-clicks",
    headers=headers,
    params={"start_date": "2026-09-22", "end_date": "2026-09-28", "limit": 2},
    timeout=30.0,
)
print(json.dumps(response.json(), indent=2))

200Retrieved

{
  "start_date": "2026-09-22",
  "end_date": "2026-09-28",
  "rate": 0.6158,
  "tracked_count": 9517,
  "no_click_count": 5861,
  "searches": [
    {
      "search": "tent footprint",
      "count": 88,
      "tracked_count": 86
    },
    {
      "search": "waterproof spray",
      "count": 61,
      "tracked_count": 60
    }
  ],
  "dates": [
    {
      "date": "2026-09-22",
      "rate": 0.6201
    },
    {
      "date": "2026-09-23",
      "rate": 0.6122
    },
    {
      "date": "2026-09-24",
      "rate": 0.6187
    },
    {
      "date": "2026-09-25",
      "rate": 0.609
    },
    {
      "date": "2026-09-26",
      "rate": 0.6175
    },
    {
      "date": "2026-09-27",
      "rate": 0.614
    },
    {
      "date": "2026-09-28",
      "rate": 0.6189
    }
  ]
}

List the most frequent tracked searches that got no click, with the no-click rate in total and per day.

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

limitintegerOptional1-1000Defaults to 10

list rows to return (the list only: counts and rates cover every row)

offsetintegerOptional>=0Defaults to 0

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

start_timestringOptional

an exact start instead of start_date: unix seconds, or ISO 8601 in UTC (2026-10-10T10:00:00Z). start_date and end_date in the reply are then the UTC days the window touches

end_timestringOptional

an exact end (exclusive): unix seconds or ISO 8601 with Z. Default: now; never later than now. Must be after start_time

Response headers

X-Captain-Applied-Seqinteger

the last update seq search had applied when this request started; the answer reflects at least that much (GET …/updates applied_seq). Not on 401 or 403, nor for an index this server does not have

X-Captain-Index-IncarnationstringOptional

the index’s incarnation, an opaque string: it changes only when the index is deleted and created again (whose seqs start again at 1), or restored from a backup (whose seqs continue from the backup’s). Sent with X-Captain-Applied-Seq

Response

report

start_datestringformat: "date"

end_datestringformat: "date"

ratedouble or null

no_click_count / tracked_count

tracked_countinteger

tracked searches

no_click_countinteger

of those, searches no click followed

searcheslist of objects

dateslist of objects

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

partialbooleanOptional

true when the search log was too large to read whole within one request’s budget: the numbers cover what was counted

partial_reasonenumOptional

row_budget: more searches than one request holds (500,000); time_budget: more than about 3.5 seconds of reading; counting (usage): days still being counted

Allowed values:

counted_throughdouble or nullOptional

the time (unix seconds) of the last record counted, when partial