canonical: https://jentic.com/apis/cookiefreeanalytics.com/cookie-free-analytics # Cookie Free Analytics read API The Cookie Free Analytics read API returns the aggregated traffic figures a site owner already sees on the dashboard, without cookies, visitor hashes, or raw per-visitor rows. It lists the sites on an account and, for each site, reports an overview of visitors, visits, pageviews, bounce rate, average duration, and live activity, plus top pages and top sources. Growth-plan sites can read linear same-day funnels, and Starter-plan sites can read uptime watch state and incidents. Every figure is a read-only aggregate scoped to a site by its siteId. ## For AI agents Read privacy-friendly, cookie-free site analytics: visitors, visits, pageviews, bounce, and duration, plus top pages, top sources, live activity, funnels, and uptime watch, per site. ## Scope Does not set cookies, collect raw visitor rows, or send events into the analytics store. Use for reading aggregated site analytics only. ## Capabilities - List the sites on an account - Read a site overview of visitors, visits, pageviews, bounce, and duration - Read the top pages and top sources for a site - Read live activity for a site in the last five minutes - Read linear same-day funnels on Growth-plan sites - Read uptime watch state and incidents on Starter-plan sites ## Use cases ### Agent traffic summary An AI agent connected through Jentic reads a site's overview and top pages, then writes a short plain-language summary of visitors, pageviews, bounce, and duration for a human. Because Cookie Free Analytics returns only aggregates, the agent never handles raw visitor data to produce the summary. Example prompt: Read the overview and top pages for a given siteId and summarize the week's traffic in two sentences ### Acquisition source reporting Marketing teams read the top sources endpoint to see where visits come from and compare it to published content. The aggregated source list lets an agent build a referrer breakdown without touching cookies or individual sessions. Example prompt: Pull the top sources for a site and rank them by share of visits ### Uptime and incident check On Starter-plan sites an agent reads the watch state and open incidents alongside traffic, so a status report can note both how many visitors arrived and whether the site had downtime. The watch endpoints report uptime, TTFB, and TLS state plus any incidents. Example prompt: Read the watch state and list any open incidents for a given siteId ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/v1/sites` | List the sites on the account | | GET | `/api/v1/sites/{siteId}/overview` | Read visitors, visits, pageviews, bounce, and duration | | GET | `/api/v1/sites/{siteId}/pages` | Read the top pages | | GET | `/api/v1/sites/{siteId}/sources` | Read the top traffic sources | | GET | `/api/v1/sites/{siteId}/funnels` | Read linear same-day funnels (Growth) | | GET | `/api/v1/sites/{siteId}/watch` | Read uptime watch state, TTFB, and TLS (Starter) | ## Key resources - **Sites** — List the sites owned on the account - **Overview** — Read visitors, visits, pageviews, bounce, duration, and live counts for a site - **Pages and sources** — Read the top pages and top traffic sources for a site - **Funnels** — Read linear same-day funnels for a Growth-plan site - **Watch** — Read uptime watch state, TTFB, TLS, and incidents for a Starter-plan site ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 56 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 72 / 100 - Developer Experience & Jentic Compatibility: 54 / 100 - AI-Readiness & Agent Experience: 39 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 50 / 100 - **View full report:** https://jentic.com/apis/cookiefreeanalytics.com/cookie-free-analytics/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Cookie Free Analytics API by hand means issuing a cfa_live_ token, learning the per-site path layout, and knowing which endpoints need the Starter or Growth plan. Through Jentic you install once, import Cookie Free Analytics from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** Cookie Free Analytics puts the siteId in the URL path (`/api/v1/sites/{siteId}/...`) and is read-only, so a rule can pin your agent to one site. You choose the read operations it may call, so it can see the overview and top pages for that site and nothing on other sites unless you add them. - **Credential handling:** Your Cookie Free Analytics token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'read site traffic' or 'list top sources', and Jentic returns the matching Cookie Free Analytics operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Plausible Analytics** — Plausible is a privacy-first, cookieless web analytics API with a similar aggregate model. - **Mixpanel** — Mixpanel tracks event-level product analytics, where Cookie Free Analytics reports page aggregates. - **PostHog** — PostHog adds product analytics, session replay, and feature flags beside page-level traffic. ## FAQ ### What authentication does the Cookie Free Analytics API use? The Cookie Free Analytics API authenticates with a bearer token in the cfa_live_ format, taken from the account area, per its OpenAPI spec. Through Jentic the token is stored once by your own self-hosted instance and injected when a call runs, so it never appears in the agent's prompt or logs. ### Can I read traffic figures for a specific site with the Cookie Free Analytics API? Yes. List your sites, then call the overview operation with the siteId to read visitors, visits, pageviews, bounce, and average duration, and use the pages and sources operations for top pages and referrers. All figures are aggregates, so no raw visitor rows are returned. ### Can I limit what my agent is allowed to do with the Cookie Free Analytics API? Yes. The API is read-only, and Cookie Free Analytics puts the siteId in the URL path, so a rule can pin your agent to one site and the overview and pages operations you choose, so it cannot read other sites on the account, with every call logged. ### What are the rate limits for the Cookie Free Analytics API? The OpenAPI spec does not specify rate limits. Check the Cookie Free Analytics documentation at https://www.cookiefreeanalytics.com for current limits before polling the live or overview endpoints frequently. ### Is there a Cookie Free Analytics MCP server? You don't need an MCP server to give your agent the Cookie Free Analytics API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent calls the overview and sources operations on demand without loading another server's tool definitions into its context. ### How do I summarize a site's traffic with the Cookie Free Analytics API through Jentic? Search Jentic by intent such as 'read site analytics overview', and Jentic returns the overview operation with its input schema so your agent passes the siteId and reads back the aggregates. To run it on your own infrastructure, install Jentic One from its GitHub repo.