NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Simple Analytics connects to a Nagent workspace with an API key. Once it is connected, agents can call 4 Simple Analytics actions, such as "List Websites (Admin API)", "Get aggregated website stats" and "Send Server-Side Event". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Simple Analytics, with input parameters and output schema.
SIMPLE_ANALYTICS_ADMIN_API_LIST_WEBSITESTool to list all websites associated with the authenticated user. Use after authenticating an admin account to retrieve website list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SIMPLE_ANALYTICS_EXPORT_API_GET_RAW_DATATool to export raw data points (page views and events) for a specific website. Use when you need to download CSV or JSON exports of site traffic.
Input parameters
List of data fields to include. Valid fields: added_date, added_iso, added_unix, browser_name, browser_version, country_code, device_type, document_referrer, duration_seconds, hostname, hostname_original, is_robot, is_unique, lang_language, lang_region, os_name, os_version, path, path_and_query, query, referrer_hostname, referrer_path, screen_height, screen_width, scrolled_percentage, session_id, user_agent, utm_campaign, utm_content, utm_medium, utm_source, utm_term, uuid, viewport_height, viewport_width
Response format: 'csv' or 'json'
End date in YYYY-MM-DD format
Website domain or site ID to export data for
Start date in YYYY-MM-DD format
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SIMPLE_ANALYTICS_GET_AGGREGATED_STATSTool to retrieve aggregated statistics for a specified website. Use when you need an overview of key metrics like visitors, pageviews, bounce rate, and more.
Input parameters
End date in YYYY-MM-DD format.
Filter stats by specific page path.
Start date in YYYY-MM-DD format.
Filter stats by traffic source.
Comparison range start date in YYYY-MM-DD format.
Website identifier (domain or custom code).
Filter stats by specific referrer host.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
SIMPLE_ANALYTICS_SEND_EVENTTool to submit server-side events or pageviews to Simple Analytics. Use for mobile apps, backend tracking, or scenarios where JavaScript is not available. Supports custom metadata for enriched event data.
Input parameters
User agent string. Avoid default library agents like 'python-requests'. Use a realistic browser user agent string.
Page path for pageviews (e.g., /my-page, /products/item-123)
Type of data point: 'event' for custom events or 'pageview' for page views
Event name for custom events (e.g., 'button_click', 'purchase') or 'pageview' for page views
Whether the connection is HTTPS. Set to true for secure connections.
UTM medium parameter for tracking campaign mediums
UTM source parameter for tracking campaign sources
Whether this is a unique visit. Set to true for the first visit from a user.
UTM content parameter for tracking campaign content variations
UTM campaign parameter for tracking campaign names
The hostname of the tracked website (e.g., example.com or composio.dev)
Language code (e.g., en-US, fr-FR, de-DE)
Custom metadata object with key-value pairs. All values must be strings.
Referrer URL (where the user came from)
Timezone (e.g., Europe/Amsterdam, America/New_York, UTC)
Screen width in pixels
Screen height in pixels
Viewport width in pixels
Viewport height in pixels
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 4 Simple Analytics actions on Nagent, including "List Websites (Admin API)", "Get aggregated website stats" and "Send Server-Side Event". List Websites (Admin API): List all websites associated with the authenticated user. Each action is listed on this page with its input parameters and its output.
Simple Analytics connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.