Menu

Documentation

Client Info API

Determine the browser, operating system, device type, IP details and language settings of the requesting client, fully server-side without external services.

Client info
https://api.flowdata.one/v1/client-info

OpenAPI file for this area

Quick start

FlowData key
This API belongs to FlowData and uses its own keys (fd_...), which you create in the dashboard under API keys. FlowSuite keys (pk_..., at_...) keep working, but we recommend a FlowData key.
No parameters needed
All data is read directly from the request headers of the requesting client. No query or body parameters are required.

Analysed data

The Client Info API reads this information from the incoming HTTP request:

  • IP address (IPv4/IPv6), numeric representation, proxy indication
  • Device type: iPhone, iPad, Android, Mac, PC, Linux, tablet or smartphone
  • Operating system with version
  • Browser: name, version, family
  • Bot detection for search engines and crawlers
  • Language preferences from the Accept-Language header

API endpoint

GET
/v1/client-info

Get client information

Reads the request headers of the requesting client and answers with the detected information. No parameters needed.

Bearer fd_…

curl -X GET "https://api.flowdata.one/v1/client-info" \
  -H "Authorization: Bearer fd_YOUR_KEY" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_YOUR_KEY')
    ->get('https://api.flowdata.one/v1/client-info');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/client-info', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_YOUR_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_YOUR_KEY',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/client-info',
    headers=headers,
)

data = response.json()
{
    "ipString": "203.0.113.42",
    "ipNumeric": 3405803818,
    "ipType": "IPv4",
    "isBehindProxy": false,
    "device": "Mac",
    "os": "Mac OS X 12.6.0",
    "userAgent": "Chrome 120.0.0",
    "family": "Chrome",
    "versionMajor": "120",
    "versionMinor": "0",
    "versionPatch": "0",
    "isSpider": false,
    "isMobile": false,
    "userAgentDisplay": "Mac OS X 12.6.0 Mac Chrome 120.0.0",
    "userAgentRaw": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    "userLanguages": [
        "de-DE",
        "de",
        "en-US",
        "en"
    ]
}

Response fields

Data fields

IP data

  • ipString: IP address as text
  • ipNumeric: numeric IP (IPv4)
  • ipType: IPv4 or IPv6
  • isBehindProxy: indication of a proxy

Device and operating system

  • device: device name
  • os: operating system with version
  • isMobile: mobile device detected

Browser

  • userAgent: browser with version
  • family: browser family
  • versionMajor, versionMinor, versionPatch: version parts
  • userAgentRaw: original user agent

Other fields

  • isSpider: bot or crawler detected
  • userLanguages: language preferences as a list
  • userAgentDisplay: summarised display text

Use cases

Analytics

  • Device and browser statistics
  • Compare mobile and desktop
  • Distribution of operating systems
  • Filter bot traffic

Security

  • Detect bot access
  • Evaluate proxy indications

One key is all it takes to start.

Create a key and call the API. Client info is free; everything else is billed per successful request.

Create an API key Documentation

FlowData is aimed exclusively at businesses and self-employed professionals.