FREE Client Info API
This API returns the public IPv4 address of the calling client along with parsed user-agent information — browser name, version, operating system, and device type. It also performs basic proxy detection by inspecting the X-Forwarded-For (XFF) header, which can reveal whether the request is coming through a proxy or load balancer.
No API key required. This endpoint is free to use directly from client environments. Responsible use is expected — repeated high-volume calls to the same endpoint without a genuine use case may result in access being restricted. If you run into issues, reach out via our contact page.
GET
https://api-bdc.net/data/client-infoResponses
200OK
Sample Request
https://api.bigdatacloud.net/data/client-infoSample Response
JSON View
Response Schema
ipStringstringReturns the client’s IP address in a string format
ipNumericintegerReturns the client’s IP address in a numeric format
ipTypestringReturns the IP address type. Expected values: "IPv4", "IPv6"
isBehindProxybooleanIndicates whether the request was detected as delivered via proxy
proxyIpstringReturns the IP address of the proxy server (omitted if no proxy detected)
devicestringThe Device type parsed from the user agent string
osstringThe OS parsed from the user agent string
userAgentstringThe User-Agent parsed from the input user agent string
familystringThe family of the device, if available
versionMajorstringThe major version of the user agent, if available
versionMinorstringThe minor version of the user agent, if available
versionPatchstringPatch version of the user agent, if available
isSpiderbooleanReturns true if the device is likely to be a spider or a bot device
isMobilebooleanReturns true if the device is likely to be of a mobile type
userAgentDisplaystringThe user agent as a readable string
userAgentRawstringThe user agent string, the input for the UA parser
userLanguagesarrayuserLanguages object
500An error has occurred and did not complete your request. Please try again
Sample Response
JSON View