---
title: "Graph Proxy Analytics"
method: GET
path: "/public/user/analytics/graph"
tags: ["Proxy Analytics"]
---

# Graph Proxy Analytics

`GET /public/user/analytics/graph`

This endpoint analyzes proxy usage for a given customer within a specified time range
and groups them by one of four discrete intervals: `minute`, `hour`, `day`, or `month`.

You can either

1. Provide a `preset` parameter, which automatically sets period and interval
   (e.g. `last_day`, `last_hour`, etc.)
2. OR, manually specify your own time range (`period_start`, `period_end`) plus `interval`

You can also filter by `hostname`, `network`, `proxy_user_id`, and `service_id`.
Service ID can only be filtered if period is within 7 days and interval is hour or less.
Hostname filters are disallowed if searching older than 90 days.

## Query parameters

- `preset` string
- `period_start` string, datetime
- `period_end` string, datetime
- `interval` 'minute' | 'hour' | 'day' | 'month'
- `hostname` string
- `network` 'datacenter' | 'isp' | 'residential' | 'mobile'
- `proxy_user_id` string
- `service_id` string
- `show_log_concurrency` boolean

## Response `200`

Analytics graphing successful.

- object
  - `data` object
    - `intervals` object[] — An array of usage data grouped by the specified interval.
      - `bytes` integer — Total bytes transferred in this interval.
      - `error` integer — Number of failed requests in this interval.
      - `interval` string — Exact timestamp (or date, if day/month) representing the interval start.
      - `interval_name` string — Human-friendly label for the interval.
      - `requests` integer — Number of total requests in this interval.
      - `smartpath_money_saved` integer — Total money in cents saved by Smartpath routing in this interval.
      - `smartpath_routed_bytes` integer — Total bytes optimized by Smartpath in this interval.
      - `smartpath_routed_requests` integer — Total requests optimized by Smartpath in this interval.
      - `successful` integer — Number of successful requests in this interval.
    - `total_bytes` integer — The sum of all data bytes transferred.
    - `total_error` integer — The total number of failed requests.
    - `total_requests` integer — The total number of requests made.
    - `total_smartpath_money_saved` integer — Total money in cents saved by Smartpath routing.
    - `total_smartpath_routed_bytes` integer — Total bytes optimized by Smartpath.
    - `total_smartpath_routed_requests` integer — Total requests optimized by Smartpath.
    - `total_successful` integer — The total number of successful requests.
  - `message` string — A success message.

---

[API](https://skmtc.dev/byteful/apis/byteful-public-user-api.md) · [All operations](https://skmtc.dev/byteful/apis/byteful-public-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/byteful/byteful-public-user-api/revisions/3db1a6fc0099/schema)