Get data is a WordPress ability from Burst Statistics — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Get data

Read-only

Fetch Burst analytics data as either an insights time series or a specific datatable (pages, referrers, countries, campaigns, search terms, and more).

Requires the Burst Statistics plugin on WordPress 6.6+. All abilities register only when the 'Enable Abilities API' setting is turned on in Burst, and the current user needs the 'manage_burst_statistics' capability. The sales-data and subscriptions-data abilities additionally require Burst Pro (the BURST_PRO constant) to be active.

What it does

This is Burst's general-purpose analytics ability. With type set to 'insights' it returns a time series broken into per-metric point arrays over a date range and interval (auto, hour, day, week, or month); with type set to 'datatable' it returns grouped rows for one of eleven endpoints — statistics_pages, statistics_parameters, statistics_referrers, sources_countries, sources_campaigns, sales_products, subscription_products, sources_referrers, outgoing-links, search-terms, or forms — filtered and grouped by the columns you request. Optional date_start/date_end, metrics, filters, group_by, and limit inputs narrow the query, and requested datatable metrics are checked against Burst's own per-endpoint allow-list. This gives an AI assistant direct access to the same analytics tables shown in the Burst dashboard so it can answer detailed traffic questions in one call.

See it in action

You ask your AI assistant

"Pull my top landing pages by pageviews and bounce rate for the last 30 days."

Inputs

Name Type Required Description
type string No Which shape of data to return: 'insights' for a time series or 'datatable' for grouped rows. The ability returns an error if this is omitted.
datatable_id string No Datatable endpoint ID, for example statistics_pages. Required when type is datatable. One of: statistics_pages, statistics_parameters, statistics_referrers, sources_countries, sources_campaigns, sales_products, subscription_products, sources_referrers, outgoing-links, search-terms, forms.
date_start integer No Unix timestamp for the start of the date range.
date_end integer No Unix timestamp for the end of the date range.
interval string No Insights-only interval override: auto, hour, day, week, or month.
metrics array No Metrics to retrieve (e.g., pageviews, visitors).
filters array No Filter objects for data retrieval.
group_by array No Grouping columns for datatable results.
limit integer No Limit on the number of results returned.

Returns

An object shaped by the requested type: for insights, 'series' (per-metric point arrays with timestamp/value), 'interval', 'spans_multiple_years', and 'point_count'; for datatable, 'dimensions', 'metrics', 'rows', and 'row_count'.

Permission

The current user must have the 'manage_burst_statistics' capability. For datatable requests, Burst additionally checks user_can_access_datatable() for the specific datatable_id and returns a 403 rest_forbidden error if access is denied. The ability is registered only when Burst's 'Enable Abilities API' setting is on.

Newsletter

The AI + WordPress space moves fast. Keep up.

New tools, workflow ideas, and product updates — be the first to know what's next.

No spam, unsubscribe anytime.