Skip to main content
GET /v1/trackers/{tracker_code}/sessions returns the raw sessions of a tracker: one row per visit, with the company, traffic source and landing page. Count the rows by the field your report needs, such as medium, campaign or landing page.

Sessions

cURL
Each row carries: Sessions come back newest first, up to 1,000 per call (limit). include_total=true adds the number of matching sessions to meta, and domain_filter narrows the rows to one company domain. When meta.has_more is true, narrow the date window (see Pagination).

Filter sessions

POST .../sessions takes the same dates plus filters on source, medium, campaign, term, content, referrer_host, click_provider, duration and pages:
Count the rows by landing_page to see which pages your paid traffic lands on, and compare duration and pages per landing page: a page where most sessions have one page view and a few seconds of active time is a page people leave at once. Swap it around and count by campaign to see which campaigns bring visitors to one page.

From a campaign to the companies behind it

A channel or campaign number becomes a company list by applying the same field as a filter on POST /companies:
paid_source equals "Linkedin Ads" gives the companies that arrived from LinkedIn paid, medium equals ai the companies referred by an AI assistant, click_provider equals "Google Ads" the companies that came in with a Google click id.

Pages of one company

GET .../companies/{company_id}/pages lists the pages one company viewed with views, first and last seen and average duration, and GET .../companies/{company_id}/sessions every session of that company in the window.

AI assistants reading your site

Companies with is_ai_agent are Claude, ChatGPT, Perplexity, Meta AI and Gemini fetching pages for their users. POST /companies with is_ai_agent equals true plus GET .../companies/{company_id}/pages per agent shows which of your pages the assistants read, a useful input for generative engine optimisation.