@graph8/sdk 0.277.0 → 0.293.0

package/docs/api/webAnalytics.md

@@ -84,9 +84,13 @@ Get UTM campaign performance.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of campaigns to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -122,9 +126,13 @@ Paid Social, Email, Referral, Display, Affiliates, Other.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -157,9 +165,13 @@ Get daily channel breakdown for stacked area charts.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -193,9 +205,13 @@ Get top referring domains.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of referrers to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -228,9 +244,13 @@ Get acquisition from search engines.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -263,9 +283,13 @@ Get acquisition from social networks.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -299,9 +323,13 @@ Get acquisition by source/medium combination.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of sources to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -334,9 +362,13 @@ Get new vs returning visitors breakdown.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -372,9 +404,13 @@ Returns top 10 entries for each category.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -408,9 +444,13 @@ Get visitor languages breakdown.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of languages to return default `20` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -445,9 +485,13 @@ Get audience overview: total users, new users, sessions, page views.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -482,9 +526,13 @@ Returns date, users, new_users, page_views, sessions per day.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -517,9 +565,13 @@ Get overall visitor-to-conversion rate.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -556,9 +608,13 @@ Extended campaign metrics including engagement quality.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of campaigns to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -593,9 +649,13 @@ Shows which channels drive best engagement quality.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -632,9 +692,13 @@ Only includes pages with at least 10 sessions.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of pages to return default `20` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -678,9 +742,13 @@ Returns:
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -720,9 +788,13 @@ Returns daily breakdown of:
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -756,9 +828,13 @@ Get custom events summary (track events).
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of events to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -792,9 +868,13 @@ Get top exit pages (last pages in sessions).
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of pages to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -828,9 +908,13 @@ Get detailed form analysis with conversion rates.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of forms to return default `20` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -864,9 +948,13 @@ Get form submission analytics.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of forms to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -899,9 +987,13 @@ Get daily form submissions trend.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -936,9 +1028,13 @@ Default funnel: Site Visitors → Viewed Form → Submitted Form → Booked Meet
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -972,9 +1068,13 @@ Get geographic distribution by city.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of cities to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1008,9 +1108,13 @@ Get geographic distribution by country.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of countries to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1046,9 +1150,13 @@ Goals: Form Submissions, Meeting Booked, Signup, Purchase.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1081,9 +1189,13 @@ Get daily trend for goal completions.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1117,9 +1229,13 @@ Get top landing pages (entry pages).
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of pages to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1157,9 +1273,13 @@ the strict charset check here is the boundary defense, mirroring
 |---|---|---|---|
 | `query.path` | `string` | yes | Exact context_page_path to roll up |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1195,6 +1315,8 @@ Get real-time analytics: active users in last 5 and 30 minutes.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1228,6 +1350,8 @@ Get active locations in real-time (last 5 minutes).
 |---|---|---|---|
 | `query.limit` | `integer \| null` | no | Number of locations to return |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1261,6 +1385,8 @@ Get active pages in real-time (last 5 minutes).
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of pages to return default `10` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1294,6 +1420,8 @@ Get traffic sources in real-time (last 5 minutes).
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of sources to return default `10` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1328,9 +1456,13 @@ Returns buckets: 1 page, 2 pages, 3 pages, 4-5 pages, 6-10 pages, 10+ pages.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1363,9 +1495,13 @@ Get technology overview: browsers, OS, and devices combined.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1400,9 +1536,13 @@ Returns buckets: 0s (bounce), 1-30s, 30s-1m, 1-3m, 3-10m, 10m+.
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -1436,9 +1576,13 @@ Get top pages by views and unique visitors.
 |---|---|---|---|
 | `query.limit` | `integer` | no | Number of pages to return default `50` |
 | `query.write_key` | `string \| null` | no | Comma-separated public keys to filter by |
+| `query.include_bots` | `boolean` | no | Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed. default `false` |
+| `query.include_internal` | `boolean` | no | Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded. default `false` |
 | `query.days` | `integer` | no | Number of days to analyze default `30` |
 | `query.date_from` | `string \| null` | no | Anchored window start (YYYY-MM-DD). Must be sent with date_to. |
 | `query.date_to` | `string \| null` | no | Anchored window end (YYYY-MM-DD). Must be sent with date_from. |
+| `query.start_date` | `string \| null` | no | Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC). |
+| `query.end_date` | `string \| null` | no | Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date. |
 | `headers.X-Org-Id` | `string \| null` | no |  |
 
 **Returns** `AnalyticsResponse`: the envelope `{ data: Record<string, unknown> | Array<unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.

package/docs/api/workflows.md

@@ -577,6 +577,12 @@ Pins ``org_id`` server-side; the caller cannot override which org's
 execution row is created. ``triggered_by`` defaults to the caller's
 user id when not supplied.
 
+If the workflow service takes the request but does not answer in time,
+the answer is ``202`` with ``outcome`` ``started`` (run found, with its
+``execution_id``) or ``unknown`` (check the executions list first), not a
+502: the run may well be going. Send an ``Idempotency-Key`` to make retries
+safe; a retry with the same key returns the first answer.
+
 **Input**
 
 | Field | Type | Required | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph8/sdk",
-  "version": "0.277.0",
+  "version": "0.293.0",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",