Ultimate Detection Overview

Device detection on your servers. Getting started guide.

This section is a general primer on setting up ultimate detection. For API information see the API v3 Documentation and examples in your API kit of choice. Ultimate detection requires the purchase of a site licence to download our database and run detections locally on your own servers. Licence pricing is available on the Pricing page.

Note : API kits ship with two modes. By default they operate in cloud mode and send requests to our API for processing, however setting the use_local flag flips the kit over into ultimate mode.

The process for setting up Ultimate Detection using each API kit is the same.

  1. Sign Up to Handset Detection.
  2. Select Add a New Site from the dropdown menu under your avatar icon and create a site profile. Ignore the redirection rules, they’re for folks using Express Detection.
  3. After your site is created you’ll get the Setup page. Click the *Ultimate* tab and grab your access credentials. You’ll need these later to configure your API Kit. You can get the setup page again at any time by clicking the Spanner or Wrench icon from your sites list.
  4. Purchase a Site Licence from your Upgrades page. Your API kit will now be able to download the necessary files from our servers.
  5. Download an API Kit, uncompress it and configure it with your credentials. Each kit is a little different however the fields/variables required will be a username, secret and site_id. Ensure you set use_local to true in your config file.

Note : the Cloud and Ultimate schemas are identical so you can get up and running with Cloud, then switch over to Ultimate when the volume picks up.

Get Started Today

Our free Express / Cloud plan has 20,000 detections per month. No credit card required. Upgrade when you're ready. We also have a free Community Edition for Ultimate Detection, our high performance local detection library, which you can build into community open source projects.


Get Started. Its Free