Web scrapingAvailable

User-Agent Generator

Generate desktop or mobile user-agent strings using user_agent_type and user_agent_count (1–5). This local operation still has a catalog request price.

Browse every endpoint with request samples, parameters and its per-request price. One API key calls them all; account limits apply.

API reference Open in Playground

At a glance

Endpoint: POST https://api.serpbase.dev/web/user-agent
Price: 1 credits / request
Authentication: X-API-Key
Result type: schemas.source_data

Endpoint and billing rules

POSThttps://api.serpbase.dev/web/user-agent

Per-request cost

1 credits / request

Each customer request uses the fixed catalog price, not a per-page rate. Web Crawl and User Agent currently cost 1 credit per request each; User Agent is not free. Genuine not-found results confirmed by source and resource identity are charged. no_results, HTTP 404 or missing hydration/parsed data alone cannot prove absence. Executed failures may currently consume credits; refunds are not guaranteed for every failure. credits_charged reports the actual charge: 0 means reported zero; null or missing means unknown. charge_status UNKNOWN remains unknown even with a numeric charge. Check account records and contact support with request_id; never assume a refund or retry blindly.

Example request parameters

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.

Example request parameters
Parameter	Example type	Example value
user_agent_count	number	1
user_agent_type	string	"desktop"

JSON

{
  "user_agent_count": 1,
  "user_agent_type": "desktop"
}

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.
Alias	Parameter	Type
country	locale.country	string
cursor	pagination.cursor	string
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string
uanum	user_agent_count	integer
uatype	user_agent_type	string

Supported devices: desktop; default: desktop.

Request examples

cURL

curl -X POST 'https://api.serpbase.dev/web/user-agent' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"user_agent_count":1,"user_agent_type":"desktop"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/web/user-agent", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"user_agent_count\":1,\"user_agent_type\":\"desktop\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

Response and API outcome

Responses are JSON. HTTP 200 is not proof of search success: inspect status and error. Fields depend on the product contract and upstream data.

View response documentation

Frequently asked questions

How much does the User-Agent Generator API cost?

Each request costs 1 credit. Credits come from prepaid packs or the monthly plan, and new accounts start with free credits.

How do I call the User-Agent Generator API?

Send a POST request to https://api.serpbase.dev/web/user-agent with your API key in the X-API-Key header. The response is JSON; check status (0 means success).

Which devices does it support?

Supported devices: desktop. The default is desktop.

Is the User-Agent Generator API available now?

Yes. Any active API key can call it.