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