0

Get Category IDs for Catalog Item

by
Published Apr 8, 2025

Get all catalog categories that a particular item is in. Returns a maximum of 100 categories per request.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `catalogs:read`

Script klaviyo Verified

The script

Submitted by hugo697 Bun
Verified 428 days ago
1
//native
2
type Klaviyo = {
3
  apiKey: string;
4
};
5
/**
6
 * Get Category IDs for Catalog Item
7
 * Get all catalog categories that a particular item is in. Returns a maximum of 100 categories per request.*Rate limits*:Burst: `350/s`Steady: `3500/m`
8

9
 */
10
export async function main(
11
  auth: Klaviyo,
12
  id: string,
13
  filter: string | undefined,
14
  page_cursor_: string | undefined,
15
  sort: "created" | "-created" | undefined,
16
  revision: string,
17
) {
18
  const url = new URL(
19
    `https://a.klaviyo.com/api/catalog-items/${id}/relationships/categories`,
20
  );
21
  for (const [k, v] of [
22
    ["filter", filter],
23
    ["page[cursor]", page_cursor_],
24
    ["sort", sort],
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
      revision: revision,
34
      "Accept": "application/vnd.api+json",
35
      Authorization: "Klaviyo-API-Key " + auth.apiKey,
36
    },
37
    body: undefined,
38
  });
39
  if (!response.ok) {
40
    const text = await response.text();
41
    throw new Error(`${response.status} ${text}`);
42
  }
43
  return await response.json();
44
}
45