DataFast Analytics Skill

Use this skill to call the DataFast API and summarize results for the user.

Quick Workflow

1. 1. Confirm the request type (overview, timeseries, realtime, breakdown, visitor, goals/payments create/delete).
2. Gather required inputs:

1. 3. Build the HTTP request with Authorization: Bearer $DATAFAST_API_KEY and Content-Type: application/json.
2. Execute with curl and parse JSON.
3. Summarize results in a table plus a short narrative (totals + key takeaways). Include pagination info if relevant.

Setup

1. 1. Get your API key from DataFast (starts with df_).
2. Store it:

Authentication

All requests need:
CODEBLOCK1

If the user hasn't set up the API key, ask them to follow the setup steps above.

Base URL

INLINECODE12

Reference Docs

Use the full API reference at {baseDir}/references/datafast-api-docs.md for endpoint details, response fields, and examples.

Endpoint Guidance

Overview

• - INLINECODE14
• Optional: startAt, endAt, timezone, fields.

Time Series

• - INLINECODE19
• Typical params: fields, interval (hour/day/week/month), startAt, endAt, timezone, limit, offset.
• Accepts filter_* query params for segmentation.
• Note: fields is required (e.g., fields=visitors,sessions).

Realtime

• - INLINECODE30
• INLINECODE31

Breakdowns

• - INLINECODE32
• INLINECODE33
• INLINECODE34
• INLINECODE35
• INLINECODE36
• INLINECODE37
• INLINECODE38
• INLINECODE39
• INLINECODE40
• INLINECODE41
• INLINECODE42

Visitor Details

• - INLINECODE43

Goals

• - Create goal: INLINECODE44
• Delete goals: DELETE /goals (requires at least one filter or time range; confirm scope)

Payments

• - Create payment: INLINECODE46
• Delete payments: DELETE /payments (confirm scope)

Destructive Actions

For DELETE /goals or DELETE /payments:

• - Always confirm exact filters and time range in plain English before executing.
• If user asks for "all time" deletion, ask for explicit confirmation.
• Echo the final URL that will be called (without the API key).

Filter Syntax

Use filter_* params for segmentation (e.g., filter_referrer=is:X).

Important: Filter values must match the exact names from breakdown endpoints. For example, X/Twitter is stored as "X" (not "x.com" or "twitter.com"). When in doubt, query the breakdown first:

curl ... "/analytics/referrers?limit=20"

Example Command Patterns

GET

POST

DELETE

Output Expectations

• - Provide a short summary and a flat table of results.
• Include totals and conversion/revenue metrics when present.
• For time series, include the top-level totals and the first/last timestamps in the selected range.
• If pagination exists, report limit, offset, and total, and ask if the user wants the next page.