UserStack delivers a real-time, easy-to-use REST API platform that parses User-Agent strings to catch device, browser, and operating system information accurately. This is one of the options you can integrate to create a helpful user experience in your application or website.
UserStack is an instant and secure User-Agent string lookup service trusted by some most innovative brands worldwide. With UserStack, you can bring user experience to perfection and identify any device, browser, and operating system by parsing User-Agent strings in real-time.
- Robust & Scalable: A few hundred API requests a month to several million daily.
- Accurate System Data: Backed by a daily updated and constantly monitored User-Agent database, the API delivers the highest level of accuracy & reliability.
- Cost-Effective Solution: With its free subscription plan, you can test out some of its features, but you can have a premium solution at less cost.
Table of Contents
How to Get a Free API Access Key?
Head over to the UserStack product pricing page and select the Free plan to get your free API access key. The free subscription plan gives you the ability to lookup 1,000 times p/moth, device, OS, and browser detection options.
Why should You Select UserStack?
UserStack is part of a big family – APILayer (and the API marketplace). This shows you that it is reliable and well-architected. Moreover, APILayer services are trusted by thousands of major companies worldwide.
Furthermore, with UserStack, you can take control of the customer journey. Do not let screen sizes get in the way of your conversions. Bring user experience to perfection and identify any device, browser, and operating system by parsing User-Agent strings in real-time.
Here are various use cases for this service:
- Tailored Advertising
- Spambot detection
- Crawler Protection
- Custom Content
How to Use Single Lookup Endpoint?
To look up a single User-Agent string, make an HTTP GET request to the API’s base URL and append the ua parameter containing your User-Agent string and your API access key.
|
1 2 3 |
https://api.userstack.com/detect ? access_key = YOUR_ACCESS_KEY & ua = Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36 |
Successful API requests will cause the UserStack API to return an extensive API response in JSON or XML format, structured into three or four different models, depending on your subscription. An API response always contains the essential data points of “ua” (user agent), “type”, “brand”, “name”, and “url”, as well as extensive modules “os”, “device” and “browser”.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
{ "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36", "type": "browser", "brand": "Apple", "name": "Mac", "url": "https://www.google.com/about/company/", "os": { "name": "macOS 10.14 Mojave", "code": "macos_10_14", "url": "https://en.wikipedia.org/wiki/MacOS_Mojave", "family": "macOS", "family_code": "macos", "family_vendor": "Apple Inc.", "icon": "https://assets.userstack.com/icons/os/macosx.png", "icon_large": "https://assets.userstack.com/icons/os/macosx_big.png" }, "device": { "is_mobile_device": false, "type": "desktop", "brand": "Apple", "brand_code": "apple", "brand_url": "http://www.apple.com/", "name": "Mac" }, "browser": { "name": "Chrome", "version": "71.0.3578.98", "version_major": "71", "engine": "WebKit/Blink" }, "crawler": { "is_crawler": false, "category": null, "last_seen": null } } |
How to Lookup Multiple User-Agent Strings?
Multiple User-Agent strings can be processed by sending an HTTP POST request to the API’s base URL containing one ua_batch[] object for each User-Agent string to process. A single Bulk Lookup request can accept up to 100 User-Agent lines.
And this provides a collection of parsed information about the given User-Agent strings. Moreover, you can learn about the other features of the UserStack API by going to its official documentation.
How to Integrate UserStack API into My Go Web App?
To integrate UserStack API into any type of application, you just need to correctly utilize the endpoints, and that is it. For instance, in this demonstration, we will make a call to detect the endpoint with the help of Go’s net/http library.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
package main import ( "encoding/json" "fmt" "net/http" ) type Device struct { Type string } type Response struct { Success bool Device Device } func main() { httpClient := http.Client{} req, err := http.NewRequest("GET", "http://api.userstack.com/detect", nil) if err != nil { panic(err) } q := req.URL.Query() q.Add("access_key", "YOUR_ACCESS_KEY") q.Add("ua", "Mozilla/5.0 (iPad; CPU OS 9_3_2 like Mac OS X) AppleWebKit/601.1.46 (KHTML, like Gecko) Version/9.0 Mobile/13F69 Safari/601.1") req.URL.RawQuery = q.Encode() res, err := httpClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() response := Response{} json.NewDecoder(res.Body).Decode(&response) if(response.Device.Type == "tablet") { fmt.Printf("It's a tablet.") } } |
Learn about how to integrate UserStack API into other programming technologies.
