User-Agent Generator — API reference

POST

Available

/web/user-agent

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.

type

web_user_agent

result

schemas.source_data

Billing

1 credits

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.

Parameters

FieldTypeAvailabilityDescription

user_agent_count

sample

number

Catalog sample; the API validates required fields.

sample: 1

user_agent_type

sample

string

Catalog sample; the API validates required fields.

sample: "desktop"

country

optional

string

optional

Public alias for locale.country. Use one spelling at a time; the API validates the parameters and values supported by this product.

cursor

optional

string

optional

Public alias for pagination.cursor. Use one spelling at a time; the API validates the parameters and values supported by this product.

device

optional

string

optional

Public alias for options.device. Use one spelling at a time; the API validates the parameters and values supported by this product.

gl

optional

string

optional

Public alias for locale.country. Use one spelling at a time; the API validates the parameters and values supported by this product.

hl

optional

string

optional

Public alias for locale.language. Use one spelling at a time; the API validates the parameters and values supported by this product.

html

optional

boolean

optional

Public alias for include_html. Use one spelling at a time; the API validates the parameters and values supported by this product.

language

optional

string

optional

Public alias for locale.language. Use one spelling at a time; the API validates the parameters and values supported by this product.

limit

optional

integer

optional

Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.

markdown

optional

boolean

optional

Public alias for include_markdown. Use one spelling at a time; the API validates the parameters and values supported by this product.

mobile

optional

boolean

optional

Public alias for options.device. Use one spelling at a time; the API validates the parameters and values supported by this product.

num

optional

integer

optional

Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.

page

optional

integer

optional

Public alias for pagination.page. Use one spelling at a time; the API validates the parameters and values supported by this product.

q

optional

string

optional

Public alias for query. Use one spelling at a time; the API validates the parameters and values supported by this product.

uanum

optional

integer

optional

Public alias for user_agent_count. Use one spelling at a time; the API validates the parameters and values supported by this product.

uatype

optional

string

optional

Public alias for user_agent_type. Use one spelling at a time; the API validates the parameters and values supported by this product.

json

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

Open in Playground

The response follows this product's contract; no recorded response example is published yet.schemas.source_data

Code and response examples

bash

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"}'

Notes

Use the catalog sample to get started, then inspect the actual JSON response.

The sample shows example parameters, not the complete request contract. Known fields are validated by the API; additional parameters are allowed.