Endpoint
POST https://requiems.xyz/v1/technology/useragent/batch
Batch Parse User Agents
Parses up to 50 user agents in a single request.
Parameters
| Name |
Type |
Required |
Location |
Description |
user_agents |
array |
yes |
body |
Array of user agents to parse (min: 1, max: 50). |
Request Example
{
"user_agents": [
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
"Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15"
]
}
Response Example
{
"data": {
"results": [
{
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
"data": {
"browser": "Chrome",
"browser_version": "124.0",
"os": "Windows",
"os_version": "10/11",
"device": "desktop",
"is_bot": false
}
},
{
"user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15",
"data": {
"browser": "Safari",
"browser_version": "",
"os": "iOS",
"os_version": "17.0",
"device": "mobile",
"is_bot": false
}
}
],
"total": 2
},
"metadata": {
"timestamp": "2026-05-19T05:33:14Z"
}
}
Response Fields
| Field |
Type |
Description |
results |
array |
List of parsed user agents results returned in the same order as the input user agents. |
results[].user_agent |
string |
The original user agent string from the input. |
results[].data |
object |
Parsed user agent details. |
results[].data.browser |
string |
Detected browser name (e.g. Chrome, Firefox, Safari, Edge, Opera, Internet Explorer, Other). Empty if not detected. |
results[].data.browser_version |
string |
Detected browser version (major.minor). Empty if not detected. |
results[].data.os |
string |
Detected operating system (e.g. Windows, macOS, Linux, Android, iOS, ChromeOS, Other). Empty if not detected. |
results[].data.os_version |
string |
Detected OS version (format varies by platform). Empty if not detected. |
results[].data.device |
string |
Device type — one of desktop, mobile, tablet, bot, or unknown |
results[].data.is_bot |
boolean |
True when the user agent matches a known bot or crawler pattern |
total |
integer |
Total number of parsed user agent results returned. |
Errors
422 validation_failed — The user_agents array is missing, empty, or contains more than 50 items.400 bad_request — Invalid JSON, malformed request body, or unexpected field types.
1---2name: useragent-post-batch3description: Parses up to 50 user agents in a single request.4---5
6## Endpoint
7
8**POST https://requiems.xyz/v1/technology/useragent/batch**
9
10## Batch Parse User Agents
11
12Parses up to 50 user agents in a single request.
13
14## Parameters
15
16| Name | Type | Required | Location | Description |
17| ---- | ---- | -------- | -------- | ----------- |
18| `user_agents` | array<string> | yes | body | Array of user agents to parse (min: 1, max: 50). |
19
20## Request Example
21
22```json
23{
24 "user_agents": [
25 "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
26 "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15"
27 ]
28 }
29```
30
31## Response Example
32
33```json
34{
35 "data": {
36 "results": [
37 {
38 "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
39 "data": {
40 "browser": "Chrome",
41 "browser_version": "124.0",
42 "os": "Windows",
43 "os_version": "10/11",
44 "device": "desktop",
45 "is_bot": false
46 }
47 },
48 {
49 "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15",
50 "data": {
51 "browser": "Safari",
52 "browser_version": "",
53 "os": "iOS",
54 "os_version": "17.0",
55 "device": "mobile",
56 "is_bot": false
57 }
58 }
59 ],
60 "total": 2
61 },
62 "metadata": {
63 "timestamp": "2026-05-19T05:33:14Z"
64 }
65}
66```
67
68## Response Fields
69
70| Field | Type | Description |
71| ----- | ---- | ----------- |
72| `results` | array<object> | List of parsed user agents results returned in the same order as the input user agents. |
73| `results[].user_agent` | string | The original user agent string from the input. |
74| `results[].data` | object | Parsed user agent details. |
75| `results[].data.browser` | string | Detected browser name (e.g. Chrome, Firefox, Safari, Edge, Opera, Internet Explorer, Other). Empty if not detected. |
76| `results[].data.browser_version` | string | Detected browser version (major.minor). Empty if not detected. |
77| `results[].data.os` | string | Detected operating system (e.g. Windows, macOS, Linux, Android, iOS, ChromeOS, Other). Empty if not detected. |
78| `results[].data.os_version` | string | Detected OS version (format varies by platform). Empty if not detected. |
79| `results[].data.device` | string | Device type — one of desktop, mobile, tablet, bot, or unknown |
80| `results[].data.is_bot` | boolean | True when the user agent matches a known bot or crawler pattern |
81| `total` | integer | Total number of parsed user agent results returned. |
82
83## Errors
84
85- `422` **validation_failed** — The user_agents array is missing, empty, or contains more than 50 items.
86- `400` **bad_request** — Invalid JSON, malformed request body, or unexpected field types.
gabrielmoreira