https://github.com/microlinkhq/top-user-agents
An always up-to-date list of the top 100 HTTP user-agents most used over the Internet.
https://github.com/microlinkhq/top-user-agents
user-agent user-agent-string user-agents
Last synced: 4 months ago
JSON representation
An always up-to-date list of the top 100 HTTP user-agents most used over the Internet.
- Host: GitHub
- URL: https://github.com/microlinkhq/top-user-agents
- Owner: microlinkhq
- License: mit
- Created: 2020-02-19T15:57:19.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2026-02-09T01:17:26.000Z (4 months ago)
- Last Synced: 2026-02-09T07:46:43.927Z (4 months ago)
- Topics: user-agent, user-agent-string, user-agents
- Language: JavaScript
- Homepage: https://microlink.io/user-agents
- Size: 516 KB
- Stars: 315
- Watchers: 4
- Forks: 21
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# top-user-agents
[](https://www.npmjs.org/package/top-user-agents)
> An always up-to-date list of the top 100 HTTP [user-agent](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent) strings most used over the Internet.
## Highlights
- **Always fresh**: Auto-updated weekly from real-world traffic data
- **Battle-tested**: Based on [+300M monthly requests](https://analytics.microlink.io/) from [microlink.io](https://microlink.io)
- **Flexible**: Get all user-agents, or filter by desktop/mobile
- **Zero dependencies**: Lightweight and fast
- **TypeScript ready**: Includes type definitions
**Download**: [All](https://cdn.jsdelivr.net/gh/microlinkhq/top-user-agents@master/src/index.json) · [Desktop](https://cdn.jsdelivr.net/gh/microlinkhq/top-user-agents@master/src/desktop.json) · [Mobile](https://cdn.jsdelivr.net/gh/microlinkhq/top-user-agents@master/src/mobile.json)
## Why top-user-agents?
When performing HTTP requests that need to look like real browser traffic (web scraping, testing, automation), you need accurate and current user-agent strings.
Most user-agent lists on the Internet are **outdated** or **unmaintained**. This list is different:
- Collected from real traffic at [microlink.io](https://microlink.io) (+300M requests/month)
- Automatically updated via CI/CD pipeline
- Covers Chrome, Firefox, Safari, Edge, and more
## Install
```bash
npm install top-user-agents
```
## Usage
### Get a random user-agent
```js
const uniqueRandomArray = require('unique-random-array')
const userAgents = require('top-user-agents')
const randomUserAgent = uniqueRandomArray(userAgents)
console.log(randomUserAgent())
// => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'
```
### Filter by device type
```js
// Desktop browsers only
const desktopAgents = require('top-user-agents/desktop')
// Mobile browsers only
const mobileAgents = require('top-user-agents/mobile')
```
### Use with fetch/HTTP requests
```js
const userAgents = require('top-user-agents')
const response = await fetch('https://example.com', {
headers: {
'User-Agent': userAgents[0]
}
})
```
## About Privacy
The information exposed to the user-agent only relies on coarse details.
In practice, anyone can put whatever they want in the user-agent string, and send it to the web server.
Because that, The user-agent cannot be sufficient condition to identify or reproduce the original request.
## Related
- [https-tls](https://github.com/Kikobeats/https-tls) – Setup TLS fingerprints to match user-agent strings.
- [@microlink/ua](https://github.com/microlinkhq/ua) – Redis primitives for tracking and ranking user-agents.
## License
**top-user-agents** © [microlink.io](https://microlink.io), released under the [MIT](https://github.com/microlinkhq/top-user-agents/blob/master/LICENSE.md) License.
Authored and maintained by [Kiko Beats](https://kikobeats.com) with help from [contributors](https://github.com/microlinkhq/top-user-agents/contributors).
> [microlink.io](https://microlink.io) · GitHub [microlink.io](https://github.com/microlinkhq) · X [@microlinkhq](https://x.com/microlinkhq)