FlowData

How do I detect browser, device and language with Client Info?

Published on 10. November 2026

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: IPv4 or IPv6.
  • isBehindProxy: true as soon as the request contains proxy headers such as X-Forwarded-For or Via.
  • device: the device type, for example PC, Mac, iPhone, iPad, Android Phone, Android Tablet or Linux Desktop. If nothing more specific can be detected, this is Desktop or Mobile.
  • os: operating system with version, such as Windows 10, Mac OS X 10.15.7, iOS 17.5 or Android 14.
  • userAgent, family: the browser with version and the browser family, for example Chrome, Edge, Firefox, Safari or Mobile Safari. Unknown browsers report Unknown.
  • versionMajor, versionMinor, versionPatch: the browser version in parts.
  • isSpider: true for search engines, bots and scripts.
  • isMobile: true for smartphones and most tablets.
  • userAgentDisplay: operating system, device and browser in one readable line.
  • userAgentRaw: the unmodified user agent, or Unknown if 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:

  1. In your application, read the User-Agent and Accept-Language headers of the visitor's request.
  2. 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.

Was this article helpful?

Back to IP Geolocation & Client Info