0

Get historical usage for a group

by
Published Apr 8, 2025

Get a group's historical usage for specific limit(s) and date range. Refer to GET /v4/groups/{group_guid}/feature_usage endpoint response for available limit names.

Script bitly Verified

The script

Submitted by hugo697 Bun
Verified 428 days ago
1
//native
2
type Bitly = {
3
  token: string;
4
};
5
/**
6
 * Get historical usage for a group
7
 * Get a group's historical usage for specific limit(s) and date range. Refer to GET /v4/groups/{group_guid}/feature_usage endpoint response for available limit names.
8
 */
9
export async function main(
10
  auth: Bitly,
11
  group_guid: string,
12
  name: string | undefined,
13
  start_date: string | undefined,
14
  end_date: string | undefined,
15
  unit: "day" | "week" | "month" | undefined,
16
) {
17
  const url = new URL(
18
    `https://api-ssl.bitly.com/v4/groups/${group_guid}/historical_usage`,
19
  );
20
  for (const [k, v] of [
21
    ["name", name],
22
    ["start_date", start_date],
23
    ["end_date", end_date],
24
    ["unit", unit],
25
  ]) {
26
    if (v !== undefined && v !== "" && k !== undefined) {
27
      url.searchParams.append(k, v);
28
    }
29
  }
30
  const response = await fetch(url, {
31
    method: "GET",
32
    headers: {
33
      Authorization: "Bearer " + auth.token,
34
    },
35
    body: undefined,
36
  });
37
  if (!response.ok) {
38
    const text = await response.text();
39
    throw new Error(`${response.status} ${text}`);
40
  }
41
  return await response.json();
42
}
43