# jsDelivr

> Read what jsDelivr, the free open-source CDN for npm packages and GitHub repositories, serves and how much. Look up a package's versions and tags, resolve a range such as ^5.2 to an exact version, list a version's files with their addresses and integrity values, find the file to load, or identify a file by its hash. Get the requests and bandwidth of a package, a version or a file, the most requested packages, and the network's traffic by CDN, country, browser and operating system. A trigger runs when a package gets a new version. No account or API key required.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/jsdelivr

## Actions

### Find file by hash

Find which package, version and file a file came from, by its SHA-256 hash: for example, to identify a library copied into a website. Works for any file jsDelivr has served at least once.

**Inputs**

- File hash (`file_hash`, text, required): The file's SHA-256: 64 hex digits, or the base64 form in an integrity attribute (sha256-...). 'List files' gives both.

**Outputs**

- `cdn_url` (text): The address jsDelivr serves it at, on cdn.jsdelivr.net.
- `file` (text): The file's path in the package, when found.
- `found` (true/false): True when jsDelivr has served a file with this hash.
- `package` (text): The package the file is in, when found.
- `sha256` (text): The hash looked up, as hex.
- `type` (text): npm or gh, when found.
- `version` (text): The version it was first served from; the same file may be in others.

**Example output**

```json
{
  "cdn_url": "https://cdn.jsdelivr.net/npm/jquery@3.2.1/dist/jquery.min.js",
  "file": "/dist/jquery.min.js",
  "found": true,
  "package": "jquery",
  "sha256": "87083882cc6015984eb0411a99d3981817f5dc5c90ba24f0940420c5548d82de",
  "type": "npm",
  "version": "3.2.1"
}
```

### Get entry points

Get the JavaScript file and stylesheet jsDelivr recommends loading from a version of an npm package, with their addresses ready for a script or link tag.

**Inputs**

- Package (`package`, text, required): An npm package, such as bootstrap or @popperjs/core.
- Version (`version`, text): Pick one, or type an exact version such as 3.7.1, a range such as 3 or ^5.2, or a tag such as latest. Leave empty for the latest version. For a GitHub repository a branch works too.

**Outputs**

- `count` (number): How many entry points there are.
- `css_url` (text): The address of the stylesheet to load, if any.
- `entry_points` (list): The files to load, one per type.
- `js_url` (text): The address of the JavaScript file to load, if any.
- `package` (text): The package: an npm name such as jquery, or owner/repo on GitHub.
- `version` (text): The exact version read, such as 3.7.1.

**Example output**

```json
{
  "count": 2,
  "css_url": "https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/css/bootstrap.min.css",
  "entry_points": [
    {
      "cdn_url": "https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.min.js",
      "file": "/dist/js/bootstrap.min.js",
      "file_type": "js",
      "guessed": false
    },
    {
      "cdn_url": "https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/css/bootstrap.min.css",
      "file": "/dist/css/bootstrap.min.css",
      "file_type": "css",
      "guessed": false
    }
  ],
  "js_url": "https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.min.js",
  "package": "bootstrap",
  "version": "5.3.8"
}
```

### Get network stats

Get all the requests and bandwidth jsDelivr served in a period, day by day and split by the CDN that served them, optionally for one continent or country.

**Inputs**

- Period (`period`, text): Which days to count. The past 1 to 365 days run to the last full day; calendar periods are whole months, quarters or years. Defaults to the past 30 days. One of: `day` (Past day), `week` (Past 7 days), `month` (Past 30 days), `quarter` (Past 90 days), `year` (Past 365 days), `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Continent (`continent`, text): Only count requests from this continent. Leave empty for the world. One of: `AF` (Africa), `AN` (Antarctica), `AS` (Asia), `EU` (Europe), `NA` (North America), `OC` (Oceania), `SA` (South America).
- Country (`country`, text): Only count requests from this country (instead of a continent). Pick one, or type a two-letter code such as US.

**Outputs**

- `bandwidth` (number): Bytes jsDelivr served in the period.
- `bandwidth_change_percent` (number): How much bandwidth rose (or fell) on the period before, in percent.
- `continent` (text): The continent the figures are limited to, as a code such as EU, or empty.
- `country` (text): The country the figures are limited to, as a code such as US, or empty.
- `days` (list): One row per day, oldest first.
- `hits` (number): Requests jsDelivr served in the period.
- `hits_change_percent` (number): How much requests rose (or fell) on the period before, in percent.
- `period` (text): The period jsDelivr reported on: day, week, month, quarter or year (the past 1, 7, 30, 90 or 365 days), s-month, s-quarter or s-year (the last calendar month, quarter or year), or a month, quarter or year such as 2026-09, 2026-Q3 or 2025.
- `period_end` (text): The last day counted, YYYY-MM-DD (UTC).
- `period_start` (text): The first day counted, YYYY-MM-DD (UTC).
- `previous_bandwidth` (number): Bytes served in the period of the same length just before.
- `previous_hits` (number): Requests in the period of the same length just before.
- `providers` (list): The CDNs jsDelivr's traffic went through, busiest first.

**Example output**

```json
{
  "bandwidth": 5606529304105253,
  "bandwidth_change_percent": -0.14,
  "continent": null,
  "country": null,
  "days": [
    {
      "bandwidth": 864264431628080,
      "date": "2026-10-13",
      "hits": 13549357144
    },
    {
      "bandwidth": 825192755151198,
      "date": "2026-10-14",
      "hits": 13430051243
    }
  ],
  "hits": 89385642853,
  "hits_change_percent": 1.94,
  "period": "week",
  "period_end": "2026-10-19",
  "period_start": "2026-10-13",
  "previous_bandwidth": 5614408037905064,
  "previous_hits": 87688021520,
  "providers": [
    {
      "bandwidth": 3927148531674942,
      "code": "CF",
      "hits": 57558473460,
      "name": "Cloudflare",
      "previous_bandwidth": 3888517638597248,
      "previous_hits": 55988620167
    },
    {
      "bandwidth": 1679380772430311,
      "code": "FY",
      "hits": 31827169393,
      "name": "Fastly",
      "previous_bandwidth": 1725890399307816,
      "previous_hits": 31699401353
    }
  ]
}
```

### Get network stats by content

Get all the requests and bandwidth jsDelivr served in a period, split by what was asked for: packages, jsDelivr's proxies, or anything else.

**Inputs**

- Period (`period`, text): Which days to count. The past 1 to 365 days run to the last full day; calendar periods are whole months, quarters or years. Defaults to the past 30 days. One of: `day` (Past day), `week` (Past 7 days), `month` (Past 30 days), `quarter` (Past 90 days), `year` (Past 365 days), `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.

**Outputs**

- `bandwidth` (number): Bytes jsDelivr served in the period.
- `content_types` (list): The traffic split by what was asked for.
- `days` (list): One row per day, oldest first.
- `hits` (number): Requests jsDelivr served in the period.
- `period` (text): The period jsDelivr reported on: day, week, month, quarter or year (the past 1, 7, 30, 90 or 365 days), s-month, s-quarter or s-year (the last calendar month, quarter or year), or a month, quarter or year such as 2026-09, 2026-Q3 or 2025.
- `period_end` (text): The last day counted, YYYY-MM-DD (UTC).
- `period_start` (text): The first day counted, YYYY-MM-DD (UTC).
- `previous_bandwidth` (number): Bytes served in the period of the same length just before.
- `previous_hits` (number): Requests in the period of the same length just before.

**Example output**

```json
{
  "bandwidth": 5606648048233813,
  "content_types": [
    {
      "bandwidth": 5506983931696374,
      "content": "packages",
      "description": "npm packages and GitHub repositories",
      "hits": 85833731397,
      "hits_share_percent": 96.02,
      "previous_bandwidth": 5518869199786355,
      "previous_hits": 84218487862
    },
    {
      "bandwidth": 75082353835848,
      "content": "proxies",
      "description": "jsDelivr's proxies, such as its WordPress and CocoaPods mirrors",
      "hits": 3405654188,
      "hits_share_percent": 3.81,
      "previous_bandwidth": 71665516952190,
      "previous_hits": 3331332477
    },
    {
      "bandwidth": 24581762701591,
      "content": "other",
      "description": "Everything else",
      "hits": 147917561,
      "hits_share_percent": 0.17,
      "previous_bandwidth": 24266064310059,
      "previous_hits": 140843125
    }
  ],
  "days": [
    {
      "bandwidth": 864321654725273,
      "date": "2026-10-13",
      "hits": 13549764427
    },
    {
      "bandwidth": 825202732933968,
      "date": "2026-10-14",
      "hits": 13430287836
    }
  ],
  "hits": 89387303146,
  "period": "week",
  "period_end": "2026-10-19",
  "period_start": "2026-10-13",
  "previous_bandwidth": 5614800781048604,
  "previous_hits": 87690663464
}
```

### Get package

Get the versions of an npm package or GitHub repository that jsDelivr can serve, newest first, with its tags (such as latest and beta) and its latest version.

**Inputs**

- Package (`package`, text, required): An npm package, such as jquery or @popperjs/core, or a GitHub repository as owner/repo, such as twbs/bootstrap.

**Outputs**

- `latest_version` (text): The version the latest tag points at; for a GitHub repository, its newest version that isn't a pre-release.
- `package` (text): The package: an npm name such as jquery, or owner/repo on GitHub.
- `tags` (list): The package's tags (npm dist-tags), such as latest and beta.
- `type` (text): 'npm' for an npm package or 'gh' for a GitHub repository, as in jsDelivr's addresses.
- `url` (text): The package's page on jsdelivr.com.
- `version_count` (number): How many versions there are.
- `versions` (list): Every version jsDelivr can serve, newest first.

**Example output**

```json
{
  "latest_version": "4.0.0",
  "package": "jquery",
  "tags": [
    {
      "tag": "beta",
      "version": "4.0.0-rc.2"
    },
    {
      "tag": "latest",
      "version": "4.0.0"
    }
  ],
  "type": "npm",
  "url": "https://www.jsdelivr.com/package/npm/jquery",
  "version_count": 5,
  "versions": [
    "4.0.0",
    "4.0.0-rc.2",
    "4.0.0-rc.1",
    "3.7.1",
    "3.7.0"
  ]
}
```

### Get package stats

Get how many requests jsDelivr served for a package in a period, and how many bytes, day by day, with its rank among all packages and the change on the period before.

**Inputs**

- Package (`package`, text, required): An npm package, such as jquery or @popperjs/core, or a GitHub repository as owner/repo, such as twbs/bootstrap.
- Period (`period`, text): Which days to count. The past 1 to 365 days run to the last full day; calendar periods are whole months, quarters or years. Defaults to the past 30 days. One of: `day` (Past day), `week` (Past 7 days), `month` (Past 30 days), `quarter` (Past 90 days), `year` (Past 365 days), `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.

**Outputs**

- `bandwidth` (number): Bytes jsDelivr served in the period.
- `bandwidth_change_percent` (number): How much bandwidth rose (or fell) on the period before, in percent.
- `bandwidth_rank` (number): Its place among all packages by bandwidth.
- `bandwidth_type_rank` (number): Its place by bandwidth among packages of its type.
- `days` (list): One row per day, oldest first.
- `hits` (number): Requests jsDelivr served in the period.
- `hits_change_percent` (number): How much requests rose (or fell) on the period before, in percent.
- `hits_rank` (number): Its place among all packages by requests, 1 for the most; empty with none.
- `hits_type_rank` (number): Its place by requests among npm packages, or among GitHub repositories.
- `package` (text): The package: an npm name such as jquery, or owner/repo on GitHub.
- `period` (text): The period jsDelivr reported on: day, week, month, quarter or year (the past 1, 7, 30, 90 or 365 days), s-month, s-quarter or s-year (the last calendar month, quarter or year), or a month, quarter or year such as 2026-09, 2026-Q3 or 2025.
- `period_end` (text): The last day counted, YYYY-MM-DD (UTC).
- `period_start` (text): The first day counted, YYYY-MM-DD (UTC).
- `previous_bandwidth` (number): Bytes served in the period of the same length just before.
- `previous_hits` (number): Requests in the period of the same length just before.
- `type` (text): 'npm' for an npm package or 'gh' for a GitHub repository, as in jsDelivr's addresses.

**Example output**

```json
{
  "bandwidth": 13255957718957,
  "bandwidth_change_percent": -0.41,
  "bandwidth_rank": 67,
  "bandwidth_type_rank": 37,
  "days": [
    {
      "bandwidth": 1915136296953,
      "date": "2026-10-13",
      "hits": 61692867
    },
    {
      "bandwidth": 1883497676452,
      "date": "2026-10-14",
      "hits": 60527264
    }
  ],
  "hits": 417813350,
  "hits_change_percent": 5.02,
  "hits_rank": 27,
  "hits_type_rank": 19,
  "package": "jquery",
  "period": "week",
  "period_end": "2026-10-19",
  "period_start": "2026-10-13",
  "previous_bandwidth": 13311090747367,
  "previous_hits": 397837998,
  "type": "npm"
}
```

### Get version stats

Get how many requests jsDelivr served for one version of a package in a period, and how many bytes, day by day.

**Inputs**

- Package (`package`, text, required): An npm package, such as jquery or @popperjs/core, or a GitHub repository as owner/repo, such as twbs/bootstrap.
- Version (`version`, text): Pick one, or type an exact version such as 3.7.1, a range such as 3 or ^5.2, or a tag such as latest. Leave empty for the latest version. For a GitHub repository a branch works too.
- Period (`period`, text): Which days to count. The past 1 to 365 days run to the last full day; calendar periods are whole months, quarters or years. Defaults to the past 30 days. One of: `day` (Past day), `week` (Past 7 days), `month` (Past 30 days), `quarter` (Past 90 days), `year` (Past 365 days), `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.

**Outputs**

- `bandwidth` (number): Bytes jsDelivr served in the period.
- `days` (list): One row per day, oldest first.
- `hits` (number): Requests jsDelivr served in the period.
- `package` (text): The package: an npm name such as jquery, or owner/repo on GitHub.
- `period` (text): The period jsDelivr reported on: day, week, month, quarter or year (the past 1, 7, 30, 90 or 365 days), s-month, s-quarter or s-year (the last calendar month, quarter or year), or a month, quarter or year such as 2026-09, 2026-Q3 or 2025.
- `period_end` (text): The last day counted, YYYY-MM-DD (UTC).
- `period_start` (text): The first day counted, YYYY-MM-DD (UTC).
- `type` (text): 'npm' for an npm package or 'gh' for a GitHub repository, as in jsDelivr's addresses.
- `version` (text): The exact version read, such as 3.7.1.

**Example output**

```json
{
  "bandwidth": 4166365369596,
  "days": [
    {
      "bandwidth": 579213428652,
      "date": "2026-10-13",
      "hits": 26608662
    },
    {
      "bandwidth": 565780446378,
      "date": "2026-10-14",
      "hits": 26137068
    }
  ],
  "hits": 182997993,
  "package": "jquery",
  "period": "week",
  "period_end": "2026-10-19",
  "period_start": "2026-10-13",
  "type": "npm",
  "version": "3.7.1"
}
```

### List a browser's countries

List the countries where a browser, or one version of it, has the biggest share of jsDelivr's requests in a calendar month, quarter or year.

**Inputs**

- Browser (`browser`, text, required): The browser, such as Chrome or Safari. Pick one, or type its name.
- Browser version (`version`, text): Only this major version of the browser, such as 152. Leave empty for every version.
- Continent (`continent`, text): Only count requests from this continent. Leave empty for the world. One of: `AF` (Africa), `AN` (Antarctica), `AS` (Asia), `EU` (Europe), `NA` (North America), `OC` (Oceania), `SA` (South America).
- Period (`period`, text): Which calendar month, quarter or year to report on. Defaults to the last calendar month. One of: `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `s-month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `browser` (text): The browser asked about.
- `continent` (text): The continent the figures are limited to, as a code such as EU, or empty.
- `count` (number): How many rows came back.
- `countries` (list): The countries where it has the biggest share of requests, biggest first.
- `period` (text): The calendar period reported on: s-month, s-quarter or s-year (the last calendar month, quarter or year), or one such as 2026-09, 2026-Q3 or 2025.
- `version` (text): The browser version asked about, if any.

**Example output**

```json
{
  "browser": "Chrome",
  "continent": "EU",
  "count": 2,
  "countries": [
    {
      "country": "RS",
      "previous_share_percent": 74.28,
      "rank": 1,
      "share_percent": 73.67
    },
    {
      "country": "HR",
      "previous_share_percent": 69.75,
      "rank": 2,
      "share_percent": 70.82
    }
  ],
  "period": "s-month",
  "version": null
}
```

### List a browser's platforms

List the operating systems a browser's requests come from in a calendar month, quarter or year, by share.

**Inputs**

- Browser (`browser`, text, required): The browser, such as Chrome or Safari. Pick one, or type its name.
- Continent (`continent`, text): Only count requests from this continent. Leave empty for the world. One of: `AF` (Africa), `AN` (Antarctica), `AS` (Asia), `EU` (Europe), `NA` (North America), `OC` (Oceania), `SA` (South America).
- Country (`country`, text): Only count requests from this country (instead of a continent). Pick one, or type a two-letter code such as US.
- Period (`period`, text): Which calendar month, quarter or year to report on. Defaults to the last calendar month. One of: `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `s-month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `browser` (text): The browser asked about.
- `continent` (text): The continent the figures are limited to, as a code such as EU, or empty.
- `count` (number): How many rows came back.
- `country` (text): The country the figures are limited to, as a code such as US, or empty.
- `period` (text): The calendar period reported on: s-month, s-quarter or s-year (the last calendar month, quarter or year), or one such as 2026-09, 2026-Q3 or 2025.
- `platforms` (list): The operating systems the browser's requests came from, biggest first.

**Example output**

```json
{
  "browser": "Chrome",
  "continent": null,
  "count": 2,
  "country": null,
  "period": "s-month",
  "platforms": [
    {
      "platform": "Windows",
      "previous_share_percent": 8.32,
      "rank": 1,
      "share_percent": 50.46
    },
    {
      "platform": "Linux",
      "previous_share_percent": 5.44,
      "rank": 2,
      "share_percent": 24.93
    }
  ]
}
```

### List a platform's browsers

List the browsers used on an operating system in a calendar month, quarter or year, by share of its requests.

**Inputs**

- Platform (`platform`, text, required): The operating system, such as Windows, Android or iOS. Pick one, or type its name.
- Continent (`continent`, text): Only count requests from this continent. Leave empty for the world. One of: `AF` (Africa), `AN` (Antarctica), `AS` (Asia), `EU` (Europe), `NA` (North America), `OC` (Oceania), `SA` (South America).
- Country (`country`, text): Only count requests from this country (instead of a continent). Pick one, or type a two-letter code such as US.
- Period (`period`, text): Which calendar month, quarter or year to report on. Defaults to the last calendar month. One of: `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `s-month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `browsers` (list): The browsers used on it, biggest share first.
- `continent` (text): The continent the figures are limited to, as a code such as EU, or empty.
- `count` (number): How many rows came back.
- `country` (text): The country the figures are limited to, as a code such as US, or empty.
- `period` (text): The calendar period reported on: s-month, s-quarter or s-year (the last calendar month, quarter or year), or one such as 2026-09, 2026-Q3 or 2025.
- `platform` (text): The operating system asked about.

**Example output**

```json
{
  "browsers": [
    {
      "browser": "Chrome",
      "previous_share_percent": 42.78,
      "rank": 1,
      "share_percent": 84.61
    },
    {
      "browser": "Microsoft Edge",
      "previous_share_percent": 34.49,
      "rank": 2,
      "share_percent": 8.35
    }
  ],
  "continent": null,
  "count": 2,
  "country": null,
  "period": "s-month",
  "platform": "Windows"
}
```

### List a platform's countries

List the countries where an operating system, or one version of it, has the biggest share of jsDelivr's requests in a calendar month, quarter or year.

**Inputs**

- Platform (`platform`, text, required): The operating system, such as Windows, Android or iOS. Pick one, or type its name.
- Platform version (`version`, text): Only this version of the operating system, such as 10 for Windows 10. Leave empty for every version.
- Continent (`continent`, text): Only count requests from this continent. Leave empty for the world. One of: `AF` (Africa), `AN` (Antarctica), `AS` (Asia), `EU` (Europe), `NA` (North America), `OC` (Oceania), `SA` (South America).
- Period (`period`, text): Which calendar month, quarter or year to report on. Defaults to the last calendar month. One of: `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `s-month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `continent` (text): The continent the figures are limited to, as a code such as EU, or empty.
- `count` (number): How many rows came back.
- `countries` (list): The countries where it has the biggest share of requests, biggest first.
- `period` (text): The calendar period reported on: s-month, s-quarter or s-year (the last calendar month, quarter or year), or one such as 2026-09, 2026-Q3 or 2025.
- `platform` (text): The operating system asked about.
- `version` (text): The version asked about, if any.

**Example output**

```json
{
  "continent": null,
  "count": 2,
  "countries": [
    {
      "country": "CX",
      "previous_share_percent": 66.74,
      "rank": 1,
      "share_percent": 88.41
    },
    {
      "country": "CC",
      "previous_share_percent": 67.53,
      "rank": 2,
      "share_percent": 86.82
    }
  ],
  "period": "s-month",
  "platform": "Windows",
  "version": "10"
}
```

### List files

List every file in one version of a package, with its size, its address on jsDelivr and the integrity value for a script or link tag. Optionally only paths containing some text, such as /dist/.

**Inputs**

- Package (`package`, text, required): An npm package, such as jquery or @popperjs/core, or a GitHub repository as owner/repo, such as twbs/bootstrap.
- Version (`version`, text): Pick one, or type an exact version such as 3.7.1, a range such as 3 or ^5.2, or a tag such as latest. Leave empty for the latest version. For a GitHub repository a branch works too.
- Path contains (`path_contains`, text): Only files whose path contains this text, such as /dist/ or .min.js. Leave empty for every file.

**Outputs**

- `count` (number): How many files are listed.
- `default_file` (text): The file jsDelivr serves for the version's own address, such as /dist/jquery.min.js.
- `default_url` (text): That file's address.
- `files` (list): The files, in path order.
- `package` (text): The package: an npm name such as jquery, or owner/repo on GitHub.
- `type` (text): 'npm' for an npm package or 'gh' for a GitHub repository, as in jsDelivr's addresses.
- `version` (text): The exact version read, such as 3.7.1.

**Example output**

```json
{
  "count": 2,
  "default_file": "/dist/jquery.min.js",
  "default_url": "https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js",
  "files": [
    {
      "cdn_url": "https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.js",
      "integrity": "sha256-eKhayi8LEQwp4NKxN+CfCh+3qOVUtJn3QNZ0TciWLP4=",
      "path": "/dist/jquery.js",
      "sha256": "78a85aca2f0b110c29e0d2b137e09f0a1fb7a8e554b499f740d6744dc8962cfe",
      "size": 285314
    },
    {
      "cdn_url": "https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js",
      "integrity": "sha256-/JqT3SQfawRcv/BIHPThkBvs0OEvtFFmqPF/lYI/Cxo=",
      "path": "/dist/jquery.min.js",
      "sha256": "fc9a93dd241f6b045cbff0481cf4e1901becd0e12fb45166a8f17f95823f0b1a",
      "size": 87533
    }
  ],
  "package": "jquery",
  "type": "npm",
  "version": "3.7.1"
}
```

### List top browsers

List the browsers jsDelivr's requests come from in a calendar month, quarter or year, by share, optionally version by version or for one continent or country.

**Inputs**

- Only this browser (`browser`, text): List this browser's versions instead of every browser. Leave empty for all browsers.
- Each version separately (`each_version`, true/false): List each version on its own row (Chrome 152, Chrome 153) instead of one row per name. Default: `false`.
- Continent (`continent`, text): Only count requests from this continent. Leave empty for the world. One of: `AF` (Africa), `AN` (Antarctica), `AS` (Asia), `EU` (Europe), `NA` (North America), `OC` (Oceania), `SA` (South America).
- Country (`country`, text): Only count requests from this country (instead of a continent). Pick one, or type a two-letter code such as US.
- Period (`period`, text): Which calendar month, quarter or year to report on. Defaults to the last calendar month. One of: `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `s-month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `browsers` (list): The browsers, biggest share first.
- `continent` (text): The continent the figures are limited to, as a code such as EU, or empty.
- `count` (number): How many rows came back.
- `country` (text): The country the figures are limited to, as a code such as US, or empty.
- `period` (text): The calendar period reported on: s-month, s-quarter or s-year (the last calendar month, quarter or year), or one such as 2026-09, 2026-Q3 or 2025.

**Example output**

```json
{
  "browsers": [
    {
      "browser": "Chrome",
      "previous_share_percent": 60.37,
      "rank": 1,
      "share_percent": 60.17,
      "version": null
    },
    {
      "browser": "Safari",
      "previous_share_percent": 23.57,
      "rank": 2,
      "share_percent": 23.36,
      "version": null
    }
  ],
  "continent": null,
  "count": 2,
  "country": null,
  "period": "s-month"
}
```

### List top countries

List the countries jsDelivr's traffic comes from in a period, biggest first, with each one's requests, bandwidth and share.

**Inputs**

- Rank by (`by`, text): Rank by the number of requests, or by bandwidth (bytes served). One of: `hits` (Requests), `bandwidth`. Default: `hits`.
- Period (`period`, text): Which days to count. The past 1 to 365 days run to the last full day; calendar periods are whole months, quarters or years. Defaults to the past 30 days. One of: `day` (Past day), `week` (Past 7 days), `month` (Past 30 days), `quarter` (Past 90 days), `year` (Past 365 days), `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many countries to return, 1 to 250. Defaults to 10. From 1 to 250.

**Outputs**

- `bandwidth` (number): Bytes served to every country in the period.
- `by` (text): What the list is ranked by: hits (requests) or bandwidth.
- `count` (number): How many rows came back.
- `countries` (list): The countries, biggest first.
- `hits` (number): Requests from every country in the period.
- `period` (text): The period jsDelivr reported on: day, week, month, quarter or year (the past 1, 7, 30, 90 or 365 days), s-month, s-quarter or s-year (the last calendar month, quarter or year), or a month, quarter or year such as 2026-09, 2026-Q3 or 2025.

**Example output**

```json
{
  "bandwidth": 24092137597477910,
  "by": "hits",
  "count": 2,
  "countries": [
    {
      "bandwidth": 6600788784972247,
      "code": "US",
      "hits": 97956314534,
      "name": "United States",
      "previous_hits": 90496970444,
      "rank": 1,
      "share_percent": 26.5
    },
    {
      "bandwidth": 5180251772920150,
      "code": "KR",
      "hits": 30757910131,
      "name": "South Korea",
      "previous_hits": 28075476486,
      "rank": 2,
      "share_percent": 8.32
    }
  ],
  "hits": 369591342306,
  "period": "s-month"
}
```

### List top files

List the most requested files of one version of a package in a period, with each one's requests, bandwidth and address.

**Inputs**

- Package (`package`, text, required): An npm package, such as jquery or @popperjs/core, or a GitHub repository as owner/repo, such as twbs/bootstrap.
- Version (`version`, text): Pick one, or type an exact version such as 3.7.1, a range such as 3 or ^5.2, or a tag such as latest. Leave empty for the latest version. For a GitHub repository a branch works too.
- Rank by (`by`, text): Rank by the number of requests, or by bandwidth (bytes served). One of: `hits` (Requests), `bandwidth`. Default: `hits`.
- Period (`period`, text): Which days to count. The past 1 to 365 days run to the last full day; calendar periods are whole months, quarters or years. Defaults to the past 30 days. One of: `day` (Past day), `week` (Past 7 days), `month` (Past 30 days), `quarter` (Past 90 days), `year` (Past 365 days), `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `by` (text): What the list is ranked by: hits (requests) or bandwidth.
- `count` (number): How many rows came back.
- `files` (list): The files, most requested first.
- `package` (text): The package: an npm name such as jquery, or owner/repo on GitHub.
- `period` (text): The period jsDelivr reported on: day, week, month, quarter or year (the past 1, 7, 30, 90 or 365 days), s-month, s-quarter or s-year (the last calendar month, quarter or year), or a month, quarter or year such as 2026-09, 2026-Q3 or 2025.
- `type` (text): 'npm' for an npm package or 'gh' for a GitHub repository, as in jsDelivr's addresses.
- `version` (text): The exact version read, such as 3.7.1.

**Example output**

```json
{
  "by": "hits",
  "count": 2,
  "files": [
    {
      "bandwidth": 14731211901199,
      "cdn_url": "https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js",
      "hits": 524736761,
      "path": "/dist/jquery.min.js",
      "rank": 1
    },
    {
      "bandwidth": 794626035823,
      "cdn_url": "https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.slim.min.js",
      "hits": 33243697,
      "path": "/dist/jquery.slim.min.js",
      "rank": 2
    }
  ],
  "package": "jquery",
  "period": "month",
  "type": "npm",
  "version": "3.7.1"
}
```

### List top packages

List jsDelivr's most requested npm packages and GitHub repositories in a period, by requests or bandwidth, with the figures for the period before.

**Inputs**

- Package type (`package_type`, text): Only npm packages, or only GitHub repositories. Leave empty for both. One of: `npm` (npm packages), `gh` (GitHub repositories).
- Rank by (`by`, text): Rank by the number of requests, or by bandwidth (bytes served). One of: `hits` (Requests), `bandwidth`. Default: `hits`.
- Period (`period`, text): Which days to count. The past 1 to 365 days run to the last full day; calendar periods are whole months, quarters or years. Defaults to the past 30 days. One of: `day` (Past day), `week` (Past 7 days), `month` (Past 30 days), `quarter` (Past 90 days), `year` (Past 365 days), `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `by` (text): What the list is ranked by: hits (requests) or bandwidth.
- `count` (number): How many rows came back.
- `package_type` (text): npm or gh when the list is limited to one type, else empty.
- `packages` (list): The packages, most requested first.
- `period` (text): The period jsDelivr reported on: day, week, month, quarter or year (the past 1, 7, 30, 90 or 365 days), s-month, s-quarter or s-year (the last calendar month, quarter or year), or a month, quarter or year such as 2026-09, 2026-Q3 or 2025.

**Example output**

```json
{
  "by": "hits",
  "count": 2,
  "package_type": null,
  "packages": [
    {
      "bandwidth": 62965689713393,
      "hits": 41159577604,
      "package": "prebid/currency-file",
      "previous_bandwidth": 61769251990383,
      "previous_hits": 40450476365,
      "rank": 1,
      "type": "gh",
      "url": "https://www.jsdelivr.com/package/gh/prebid/currency-file"
    },
    {
      "bandwidth": 356531489636331,
      "hits": 18787374800,
      "package": "swiper",
      "previous_bandwidth": 363613605090770,
      "previous_hits": 19048279001,
      "rank": 2,
      "type": "npm",
      "url": "https://www.jsdelivr.com/package/npm/swiper"
    }
  ],
  "period": "s-month"
}
```

### List top platforms

List the operating systems jsDelivr's requests come from in a calendar month, quarter or year, by share, optionally version by version or for one continent or country.

**Inputs**

- Only this platform (`platform`, text): List this operating system's versions instead of every platform. Leave empty for all platforms.
- Each version separately (`each_version`, true/false): List each version on its own row (Chrome 152, Chrome 153) instead of one row per name. Default: `false`.
- Continent (`continent`, text): Only count requests from this continent. Leave empty for the world. One of: `AF` (Africa), `AN` (Antarctica), `AS` (Asia), `EU` (Europe), `NA` (North America), `OC` (Oceania), `SA` (South America).
- Country (`country`, text): Only count requests from this country (instead of a continent). Pick one, or type a two-letter code such as US.
- Period (`period`, text): Which calendar month, quarter or year to report on. Defaults to the last calendar month. One of: `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `s-month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `continent` (text): The continent the figures are limited to, as a code such as EU, or empty.
- `count` (number): How many rows came back.
- `country` (text): The country the figures are limited to, as a code such as US, or empty.
- `period` (text): The calendar period reported on: s-month, s-quarter or s-year (the last calendar month, quarter or year), or one such as 2026-09, 2026-Q3 or 2025.
- `platforms` (list): The operating systems, biggest share first.

**Example output**

```json
{
  "continent": null,
  "count": 2,
  "country": null,
  "period": "s-month",
  "platforms": [
    {
      "platform": "Windows",
      "previous_share_percent": 23.0,
      "rank": 1,
      "share_percent": 23.91,
      "version": "10",
      "version_name": null
    },
    {
      "platform": "macOS",
      "previous_share_percent": 6.13,
      "rank": 2,
      "share_percent": 5.93,
      "version": "10.15",
      "version_name": "Catalina"
    }
  ]
}
```

### List top versions

List a package's most requested versions in a period, with each one's requests and bandwidth: which versions people still load.

**Inputs**

- Package (`package`, text, required): An npm package, such as jquery or @popperjs/core, or a GitHub repository as owner/repo, such as twbs/bootstrap.
- Rank by (`by`, text): Rank by the number of requests, or by bandwidth (bytes served). One of: `hits` (Requests), `bandwidth`. Default: `hits`.
- Period (`period`, text): Which days to count. The past 1 to 365 days run to the last full day; calendar periods are whole months, quarters or years. Defaults to the past 30 days. One of: `day` (Past day), `week` (Past 7 days), `month` (Past 30 days), `quarter` (Past 90 days), `year` (Past 365 days), `s-month` (Last calendar month), `s-quarter` (Last calendar quarter), `s-year` (Last calendar year), `pick_month` (A month you pick), `pick_quarter` (A quarter you pick), `pick_year` (A year you pick). Default: `month`.
- Date in that period (`period_date`, date): Any day in the month, quarter or year to report on. jsDelivr reports only on periods that have ended, back to 2020 (browsers and platforms back to 2022). Only when Period is A month you pick, A quarter you pick or A year you pick.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.
- Page (`page`, number): Which page of results, 1 to 100, for more than one page holds. Defaults to 1. From 1 to 100.

**Outputs**

- `by` (text): What the list is ranked by: hits (requests) or bandwidth.
- `count` (number): How many rows came back.
- `package` (text): The package: an npm name such as jquery, or owner/repo on GitHub.
- `period` (text): The period jsDelivr reported on: day, week, month, quarter or year (the past 1, 7, 30, 90 or 365 days), s-month, s-quarter or s-year (the last calendar month, quarter or year), or a month, quarter or year such as 2026-09, 2026-Q3 or 2025.
- `type` (text): 'npm' for an npm package or 'gh' for a GitHub repository, as in jsDelivr's addresses.
- `versions` (list): The versions, most requested first.

**Example output**

```json
{
  "by": "hits",
  "count": 2,
  "package": "jquery",
  "period": "month",
  "type": "npm",
  "versions": [
    {
      "bandwidth": 15962970949282,
      "hits": 565613445,
      "rank": 1,
      "type": "version",
      "version": "3.7.1"
    },
    {
      "bandwidth": 8425893778107,
      "hits": 248182902,
      "rank": 2,
      "type": "version",
      "version": "3.6.0"
    }
  ]
}
```

### Resolve version

Find the exact version a range such as ^5.2 or a tag such as latest points at now, with the address jsDelivr serves it at. Says so, rather than failing, when nothing matches.

**Inputs**

- Package (`package`, text, required): An npm package, such as jquery or @popperjs/core, or a GitHub repository as owner/repo, such as twbs/bootstrap.
- Version range or tag (`version`, text): The range or tag to resolve, such as 3, ^5.2, ~4.6.0 or beta. Defaults to latest.

**Outputs**

- `cdn_url` (text): The address of that version on cdn.jsdelivr.net; add a file's path to load the file.
- `found` (true/false): True when a version matches it.
- `package` (text): The package: an npm name such as jquery, or owner/repo on GitHub.
- `requested` (text): The range or tag asked about, such as 3 or latest.
- `type` (text): 'npm' for an npm package or 'gh' for a GitHub repository, as in jsDelivr's addresses.
- `version` (text): The exact version it points at now, or empty if none.

**Example output**

```json
{
  "cdn_url": "https://cdn.jsdelivr.net/npm/jquery@3.7.1",
  "found": true,
  "package": "jquery",
  "requested": "3",
  "type": "npm",
  "version": "3.7.1"
}
```
