FREE Client Info API
Introduction
The Free Client Info API is a fast and simple way to establish the public IPv4 address and browser details of your customers. It offers proxy detection by examining the X-Forwarded-For (XFF) HTTP header field and detailed User-Agent (UA) information, providing a quick overview of the visitor and the device that they are using to access your services.
Response Format
The response should be expected in JSON format
Field |
Data type |
Description |
ipString |
string |
Returns the client’s IP address in a string format |
ipNumeric |
32 bit unsigned integer |
Returns the client’s IP address in a numeric format |
ipType |
string |
Returns the IP address type. Possible values: "IPv4" |
isBehindProxy |
boolean |
Indicates if the request was detected as delivered via proxy |
proxyIp |
string |
Returns the IP address of the proxy server (omitted if no proxy detected) |
device |
string |
The Device parsed from the user agent string |
os |
string |
The OS parsed from the user agent string |
userAgent |
string |
The User-Agent parsed from the user agent string |
family |
string |
The family of the device, if available |
versionMajor |
string |
The major version of the user agent, if available |
versionMinor |
string | The minor version of the user agent, if available |
versionPatch |
string | Patch version of the user agent, if available |
isSpider |
string | Returns true if the device is likely to be a spider or a bot device |
isMobile |
bool | Returns true if the device is likely to be of a mobile type |
userAgentDisplay |
string | The user agent as a readable string |
userAgentRaw |
string | The user agent string, the input for the UA parser |
userLanguages |
array of string | List of user languages as reported by the client |
API Endpoint
Endpoint: | /data/client-info |
---|---|
Full URL: | https://api.bigdatacloud.net/data/client-info |