Client Info evaluates what a browser or program sends with every request: IP address, browser and version, operating system, device type and preferred languages. You can use it to preselect the language of a page, break statistics down by device or filter out bots. Everything is read directly from the request, with no external service involved.
The request
Client Info has no parameters:
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_YOUR_KEY"
The response
This is the response for a Chrome browser on Windows with German language settings:
{
"ipString": "203.0.113.24",
"ipNumeric": 3405803800,
"ipType": "IPv4",
"isBehindProxy": false,
"device": "PC",
"os": "Windows 10",
"userAgent": "Chrome 130.0.0.0",
"family": "Chrome",
"versionMajor": "130",
"versionMinor": "0",
"versionPatch": "0",
"isSpider": false,
"isMobile": false,
"userAgentDisplay": "Windows 10 PC Chrome 130.0.0.0",
"userAgentRaw": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36",
"userLanguages": ["de-DE", "de", "en"]
}
The fields in detail:
- ipString: the caller's IP address.
- ipNumeric: the same address as a number, handy for range comparisons. IPv4 only; with IPv6 this is
null. - ipType:
IPv4orIPv6. - isBehindProxy:
trueas soon as the request contains proxy headers such asX-Forwarded-FororVia. - device: the device type, for example
PC,Mac,iPhone,iPad,Android Phone,Android TabletorLinux Desktop. If nothing more specific can be detected, this isDesktoporMobile. - os: operating system with version, such as
Windows 10,Mac OS X 10.15.7,iOS 17.5orAndroid 14. - userAgent, family: the browser with version and the browser family, for example
Chrome,Edge,Firefox,SafariorMobile Safari. Unknown browsers reportUnknown. - versionMajor, versionMinor, versionPatch: the browser version in parts.
- isSpider:
truefor search engines, bots and scripts. - isMobile:
truefor smartphones and most tablets. - userAgentDisplay: operating system, device and browser in one readable line.
- userAgentRaw: the unmodified user agent, or
Unknownif there is none. - userLanguages: the preferred languages in the order the browser sends them, without weights. The list is empty if no language is sent.
Your visitor's data instead of your server's
Because your key belongs on the server, the request to Client Info normally comes from your server. Without anything else, the response then describes your server and the program sending the request, such as curl or an HTTP library.
For your visitor's browser, device and language, pass on their headers:
- In your application, read the
User-AgentandAccept-Languageheaders of the visitor's request. - Send them unchanged in your request to Client Info:
curl "https://api.flowdata.one/v1/client-info" \
-H "Authorization: Bearer fd_YOUR_KEY" \
-H "User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1" \
-H "Accept-Language: de-DE,de;q=0.9"
The response then includes "device": "iPhone", "os": "iOS 17.5", "userAgent": "Mobile Safari 17.5", "isMobile": true and "userLanguages": ["de-DE", "de"].
The IP address in ipString remains that of your server. To get your visitor's location, query IP Geolocation with their IP address; see Why does IP Geolocation show my server's location instead of my visitor's?.
Why is isSpider true in my test?
Client Info recognizes not only search engines but also typical tools and scripts. If the user agent contains something like curl, wget, python-requests, Postman, bot, crawler or spider, isSpider is true. A test with curl or Postman is therefore deliberately treated as a bot. For testing, send a real browser user agent as in the example above.
Why does Windows 11 show as Windows 10?
Browsers report Windows 10 and Windows 11 with the same identifier in the user agent, so the two can't be told apart from it. Client Info shows Windows 10 for both.
Why is my Android tablet detected as an Android Phone?
Many Android tablets send the same user agent as a smartphone. Client Info only reports Android Tablet if the word "tablet" appears in the user agent. If you need an exact distinction, combine this with the screen width, which you can read in the browser yourself.
Good to know
- Client Info is free, but you still need a valid FlowData key; see Create a FlowData API key.
- Every request appears in the Log under Areas › Client Info. The eye icon shows the IP address and user agent of the request.
- The full reference is in the API documentation.