For AI agents: a documentation index is available at /llms.txt
Skip to main content

ProxyOptions

Properties

PropertyTypeDescription
city?stringThe city you wish to proxy through. Any spaces should be removed and all casing lowercase. For instance, "New York City" should be "newyorkcity"
country?CountryCodeThe country you wish to proxy through. Only allowed when using the browserless.io proxy and no server argument.
method?Method[]The Method(s) of the request you'd like to proxy
network?ProxyNetworkThe Browserless proxy network to route matching requests through: residential (default) or datacenter. Only valid for the browserless.io proxy network (not with server). Default residential
operator?OperatorTypeWhether to "or" conditions together, meaning any condition that matches will be proxied, or "and" them together meaning every condition must match to proxy the request. Default or
preset?stringA preset code for website-specific proxy configurations. Use this with known presets like "px_gov01" for government websites. Only applies to the residential network; the datacenter pool ignores it
server?stringAn external proxy to use for these requests matching the specified patterns set in the other arguments. When this is set then country, city, state and sticky options will throw errors as these are only valid for the browserless.io proxy network
state?stringThe state or provence you wish to proxy through. Any spaces should be removed and all casing lowercase. For instance, "Rhode Island" would be "rhodeisland" and "New Brunswick" would be "newbrunswick"
sticky?booleanWhether or not you want the same IP to be used for subsequent requests matching the pattern
type?ResourceType[]The content-type of the request you'd like to proxy requests to
url?string[]A glob-style URL pattern to match requests, and if matched, are proxied through