---
title: "API search usage analytics"
method: GET
path: "/analytics/searches"
---

# API search usage analytics

`GET /analytics/searches`

Privacy-safe aggregate activity categories from free REST/MCP discovery and the free resume compiler. Raw queries, candidate evidence, identities, job/application/artifact/request identifiers, IP addresses, API keys, user agents, and locations are excluded from aggregate datasets. Search cohorts smaller than three requests and compiler cohorts smaller than five events are suppressed. Counts are requests or compiler events, not unique people, purchase intent, acceptance probability, outcomes, causal evidence, or revenue proof. Organic ranking is unaffected. provider_signal_eligibility is a historical counterfactual, not an actual exposure count.

## Query parameters

- `days` integer

## Response `200`

Search and compiler analytics aggregates including cohort-protected historical provider-signal eligibility, explicitly separated from actual exposure events

- object
  - `total_requests` integer
  - `provider_signal_eligibility` object — Historical cohort-protected requests that would satisfy current REST signal rules. This is not an actual exposure or buyer count.
    - `measurement_available` boolean
    - `historical_counterfactual` boolean
    - `actual_exposures_included` boolean
    - `actual_exposure_event` string
    - `cohort_qualified_requests` integer
    - `eligible_by_endpoint` object[]
      - `endpoint` string
      - `count` integer
    - `eligible_by_demand_category` object[]
      - `category` string
      - `count` integer
    - `minimum_cohort_size` integer
    - `measurement_unit` string
    - `unique_people_claimed` boolean
    - `buyer_intent_claimed` boolean
    - `raw_queries_included` boolean
    - `raw_identifiers_included` boolean
  - `candidate_resume_demand` object — Cohort-protected fixed-taxonomy compiler-event demand. It excludes raw candidate evidence and all candidate, job, application, artifact, request, and IP identifiers and makes no acceptance or causal claim.
    - `measurement_available` boolean
    - `cohort_qualified_compilations` integer
    - `demand_categories` object[]
    - `missing_signal_tags` object[]
    - `covered_signal_tags` object[]
    - `coverage_buckets` object[]
    - `privacy` object
    - `measurement` object

---

[API](https://skmtc.net/aidevboard/apis/ai-dev-jobs-api.md) · [All operations](https://skmtc.net/aidevboard/apis/ai-dev-jobs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aidevboard/ai-dev-jobs-api/versions/982076176568/schema)