New here? Get started explains OAuth and API tokens, with setup for both.
All tools are prefixed datasense_, read-only, and mirror the REST API 1:1: same arguments, validation and permissions. Each tool's arguments and response are on its API reference page.
Tools that read one website take websiteId. A website key implies it, and so does a connection or token that reaches exactly one website. Ranges are startAt and endAt (YYYY-MM-DD); leave both out for all time.
Analytics
| Tool |
Description |
Permission |
datasense_analytics_metadata |
Website display metadata: name, domain, timezone and reporting currency. |
analytics:read |
datasense_analytics_overview |
Visitors, pageviews, sessions, bounce rate, session duration, revenue and conversion rate for a range, with the previous period of the same length and the change. The headline numbers on the dashboard. |
analytics:read |
datasense_analytics_timeseries |
Visitors, pageviews and revenue per minute, hour, day, week or month. |
analytics:read |
datasense_analytics_realtime |
Visitors online in the last 5 minutes, their top pages, referrers and countries, pageviews per minute for the last 30 minutes, and the latest pageviews and goals. |
analytics:read |
datasense_analytics_realtime_map |
Visitors per country over the last 30 minutes, as on the live map. |
analytics:read |
Breakdowns
| Tool |
Description |
Permission |
datasense_analytics_pages |
Top pages by visitors, with the revenue of sessions that landed on them. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
datasense_analytics_referrers |
Traffic sources: referrer domains, with Direct for visits without one. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
datasense_analytics_campaigns |
UTM campaigns (utm_campaign) by visitors and revenue. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
datasense_analytics_countries |
Visitors by country, as ISO codes. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
datasense_analytics_regions |
Visitors by region or state, labelled CC:Name. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
datasense_analytics_cities |
Visitors by city, labelled CC:Name. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
datasense_analytics_browsers |
Visitors by browser. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
datasense_analytics_operating_systems |
Visitors by operating system. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
datasense_analytics_devices |
Visitors by device type: Desktop, Mobile or Tablet. Each row has visitors, pageviews and revenue attributed to sessions that started there. |
analytics:read |
Goals
Errors
| Tool |
Description |
Permission |
datasense_errors_list |
JavaScript errors grouped by message, most frequent first, with counts, affected visitors, pages, browsers and the latest stack. Covers the website's latest 100 errors. |
analytics:read |
Bot traffic
| Tool |
Description |
Permission |
datasense_bot_traffic_summary |
AI answer, indexing, training and other crawler requests, IP verification, providers and crawlers for a range. Pro and Team plans. |
analytics:read |
datasense_bot_traffic_pages |
The pages crawlers request most, the discovery files they read (robots.txt, llms.txt, sitemaps, .md pages) and the pages that returned 404. Pro and Team plans. |
analytics:read |
Visitors
| Tool |
Description |
Permission |
datasense_visitors_search |
Visitors in a range with their pageviews, sessions, time on site, source, location, device and lifetime revenue. Segment, sort and search them. Names and emails need the visitors:details permission. |
analytics:read + visitors:read |
datasense_visitors_get |
One visitor's profile: first touch, totals, goals, top pages and their latest sessions with every pageview, goal, payment and error. Identity needs visitors:details. |
analytics:read + visitors:read |
Websites
| Tool |
Description |
Permission |
datasense_websites_list |
The websites this credential can access, with their names, domains and timezones. |
websites:read |
datasense_websites_get |
One website's settings: timezone, tracking mode, session replay, plan features and when its last event arrived. |
settings:read |
Account
| Tool |
Description |
Permission |
datasense_account_get |
The caller's name, email and plan, with the plan's limits. |
account:read |