UserAgent.one

The user-agents NPM package, served via free API

Access random, realistic user-agent strings from the popular user-agents NPM package — directly in the browser, without needing Node.

Hit a simple GET endpoint. Filter as needed. Fresh data, updated daily. No sign-up required.

API Guide

Endpoint

https://useragent.one/api/user-agents

Make a GET request to the API with optional filters


  fetch(https://useragent.one/api/user-agents?deviceCategory=desktop&limit=1)
    .then(res => res.json())
    .then(console.log);

Receive a JSON response


      
  {
      success: true,
      msg: "",
      data: [{
          "appName": "Netscape",
          "connection": {
          "downlink": 10,
          "effectiveType": "4g",
          "rtt": 0
          },
          "platform": "Win32",
          "pluginsLength": 3,
          "vendor": "Google Inc.",
          "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36",
          "viewportHeight": 660,
          "viewportWidth": 1260,
          "deviceCategory": "desktop",
          "screenHeight": 800,
          "screenWidth": 1280
      }]
  }

Query Parameters

limit
Maximum number of user-agents to return. Defaults to 1.
1–50
deviceCategory
Filter by device type.
"desktop" | "mobile" | "tablet"
platform
Exact value of `navigator.platform`.
string
vendor
Exact value of `navigator.vendor`.
string
appName
Exact value of `navigator.appName`.
string
language
Exact value of `navigator.language`.
string
screenHeight
Screen height in pixels.
number
screenWidth
Screen width in pixels.
number
viewportHeight
Viewport height in pixels.
number
viewportWidth
Viewport width in pixels.
number
pluginsLength
Length of `navigator.plugins` array.
number

Limits

  • 60 requests per minute
  • 50 user agents per request max