Analytics

Get job-detail visitors by first-touch channel

Changed on

Paginated unique visitors (sessions) that viewed a job-detail page, grouped by company slug, job slug, and first-touch channel (ADR-0029). First-touch UTM campaign/source/medium are included when the landing href was tagged (empty otherwise). visitors counts unique sessions and will always be lower than views in the jobs export; the two are not expected to match. Join companySlug + jobSlug to jobs export company_slug + slug — unlike GET /v1/analytics/apply-clicks, which joins on jobId / export id. Inclusive UTC start/end (YYYY-MM-DD) so scheduled pulls can be incremental; defaults to the last 30 completed UTC days ending yesterday. Max range 366 days. Page with limit (1–1000, default 100) and cursor. Requires analytics.read.

get/analytics/job-visitors

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/analytics/job-visitors
  • Auth: HTTP bearer

Query parameters

startstring

Inclusive range start (UTC date-only YYYY-MM-DD).

endstring

Inclusive range end (UTC date-only YYYY-MM-DD).

limitinteger

Page size (1–1000). Defaults to 100. Not a board-wide top-N cap.

cursorstring

Opaque page cursor from the previous nextCursor.

Response

Job-detail visitors by first-touch channel and campaign.

object'list' required
urlstring required
hasMoreboolean required
nextCursorstring nullable required
countinteger

Total number of results matching the query.

limitinteger

The page size used for this response.

offsetinteger

The number of results skipped before this page.

gatedCountinteger

Jobs hidden behind the candidate paywall for the current viewer; absent or 0 for an entitled viewer.

Example response

{
  "url": "/v1/analytics/job-visitors"
}

Changes