# useragents-me-api

> Node.js wrapper for useragents.me

Latest version **1.2.0** (published 2025-04-01) · MIT license · 0 weekly downloads

## Install

```sh
npm install useragents-me-api
pnpm add useragents-me-api
yarn add useragents-me-api
bun add useragents-me-api
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.0 |
| Published | 2025-04-01 |
| First published | 2022-12-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 8.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 16 |
| Author | DavideViolante |
| Maintainers | davideviolante |
| Keywords | user, agent, user agent, user agents, users agent, ua |

## Links

- npm: https://www.npmjs.com/package/useragents-me-api
- Repository: https://github.com/DavideViolante/useragents-me-api
- Homepage: https://github.com/DavideViolante/useragents-me-api#readme
- Issues: https://github.com/DavideViolante/useragents-me-api/issues
- npm.io page: https://npm.io/package/useragents-me-api

## Dependencies (2)

- [axios](https://npm.io/package/axios.md) ^1.8.4
- [cheerio](https://npm.io/package/cheerio.md) ^1.0.0

## Alternatives

- [d3-force-3d](https://npm.io/package/d3-force-3d.md) — 1.0M weekly downloads
- [ng2-charts](https://npm.io/package/ng2-charts.md) — 486.8K weekly downloads
- [@arcgis/core](https://npm.io/package/@arcgis/core.md) — 257.8K weekly downloads
- [react-sparklines](https://npm.io/package/react-sparklines.md) — 249.3K weekly downloads
- [react-native-gifted-charts](https://npm.io/package/react-native-gifted-charts.md) — 182.3K weekly downloads

## Recent versions

- 1.2.0 (latest) — 2025-04-01
- 1.1.0 — 2025-02-17
- 1.0.1 — 2025-01-06
- 1.0.0 — 2022-12-18

## README

# Useragents.me Node.js APIs wrapper
[![](https://github.com/davideviolante/useragents-me-api/workflows/Node.js%20CI/badge.svg)](https://github.com/DavideViolante/useragents-me-api/actions?query=workflow%3A"Node.js+CI") [![Coverage Status](https://coveralls.io/repos/github/DavideViolante/useragents-me-api/badge.svg?branch=master)](https://coveralls.io/github/DavideViolante/useragents-me-api?branch=master) [![Maintainability](https://api.codeclimate.com/v1/badges/ded2c349739e4d87130b/maintainability)](https://codeclimate.com/github/DavideViolante/useragents-me-api/maintainability) ![npm](https://img.shields.io/npm/dm/useragents-me-api) [![Donate](https://img.shields.io/badge/paypal-donate-179BD7.svg)](https://www.paypal.me/dviolante)

[![NPM](https://nodei.co/npm/useragents-me-api.png)](https://nodei.co/npm/useragents-me-api/)

Simple Node.js wrapper for [useragents.me](https://useragents.me).

### Install
`npm i useragents-me-api`

### Example
```js
const { useragentsme } = require('useragents-me-api');

async function main() {
  try {
    // Get most common mobile user agents
    const mobileUserAgents = await useragentsme(); // Default arg is 'mobile'
    console.log(mobileUserAgents); // [{"ua": "Mozilla/5.0...", "pct": 44.123...}, ...]
    // Get most common desktop user agents
    const desktopUserAgents = await useragentsme('desktop');
    console.log(desktopUserAgents); // [{"ua": "Mozilla/5.0...", "pct": 40.123...}, ...]
  } catch (error) {
    console.log(error);
  }
}
```

### Run tests
```npm test```

### Run lint
```npm run lint```

### Author
- [Nicholas Beaton](https://github.com/stayml/)
- [Davide Violante](https://github.com/DavideViolante/)

---
_Source: https://npm.io/package/useragents-me-api · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._