AI & Agent Traffic

Web analytics query format (Growth+)

Changed on

How to query the web analytics provider connected to the project, live: the provider, the property every query runs on, the native query format it accepts, the allowed top-level fields, the rules the bridge enforces (the connected property is always used, only reads run, row limits), a worked example and, where the provider offers it, its live field list. Cached for an hour. Supported providers: Google Analytics 4, Adobe Analytics or Customer Journey Analytics, Matomo, PostHog, Plausible and Piano, connected on the AI Traffic page. Requires the Growth plan or above; otherwise ERR_PLAN_REQUIRED. Without a connected provider returns ERR_WEB_ANALYTICS_NOT_CONNECTED (404); a provider that refuses the stored credentials returns ERR_WEB_ANALYTICS_ACCESS_REVOKED (403); an unavailable provider, an exhausted provider quota, more than 20 uncached queries a minute or too many running at once for the project returns ERR_WEB_ANALYTICS_UPSTREAM (503): wait for the number of seconds in Retry-After before retrying.

get/web_analytics/schema

Request

  • Base URL
    https://api.llmpulse.ai/api/v1
  • URL
    https://api.llmpulse.ai/api/v1/web_analytics/schema
  • Auth
    API key in header Authorization

Query parameters

project_idinteger required

Project ID

Response

Query format for the connected provider

project_idinteger
provider'google_analytics' | 'adobe_analytics' | 'matomo' | 'posthog' | 'plausible' | 'piano'

The connected web analytics provider.

propertystring

The property, site, report suite (rsid:...), data view (dataview:...) or project every query runs on.

query_languagestring

The native query format the provider accepts.

docs_urlstring

The provider's reference for that format.

allowed_fieldsstring[]

Top-level query fields that are forwarded.

rulesstring[]

What the bridge enforces and the provider's main constraints.

exampleobject

A worked query to adapt.

fieldsobject nullable

The provider's live field list where it offers one: GA4 dimensions and metrics with custom definitions, Adobe ids, Matomo report methods, PostHog event names, the Plausible catalog. Null when the provider did not return it.

fields_unavailablestring

Present when the field list could not be read; the format and example still apply.

request_idstring

Changes