Realtime User Profiling and Scoring

REST API

The Gator Analytics user profiling and scoring API provides the ability to get real-time intel on your users from any platform you are using. It uses a standard REST interface that returns a JSON object with the profile data. It can be integrated into any major platform.

This information provided by the API includes:

Data	Use
Fraud score	Know whether the user is real or a bot. Here is our detection methodology.
Device data	Instantly know what kind of device type the user in on (desktop/mobile/tablet, etc.). Over 22,000 specific devices are detected.
Geolocation and demographics	Know median household income, home values, and age and gender breakdowns on the location of the user.
Organization	See what organization a user is originating from, whether it's an ISP, corporation, university or government agency.
Technology	Get detailed browser and platform (with versions) data on your users.
Search info	Over 200 search engines are detected. See if your user was referred by a search engine and with what keywords (if they are provided).

Integrate in Minutes

For help on how to implement the API, see our profile and scoring documentation.

The API is easily integrated into your systems. To the right are some examples. More extensive examples are at our profile and scoring documentation help section.

Developers, try it out with our API tester:

To use the production version, signup for an account and get an access token with query rights.

After signing up, for help on how to get an access token, see our access token documentation.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Web;
using System.Net;
using System.IO;

namespace ConsoleApplication1
{
    public class Class1
    {

//  The user scoring/profiling endpoint.
        public const string API_URL = "https://api-v1.gator.io/v1/score";

static void Main(string[] args)
        {
            Class1.CreateObject();
        }

private static void CreateObject()
        {
            //  To use the API in production, create an account and get an access token from the website.  Then assign it to the accessToken variable below.  Calls
            //  without an access token will be rate limited.
            string accessToken = "";  //  change this to an access token for production use

//  set up the parameters for the API call
            string ip = "72.203.234.33";    //  The I.P. address of the user

//  the user agent of the user, if known
            string ua = "Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405";

//  the url of the request to your platform
            string url = "http://www.mysite.com?utm_campaign=BingAds";

//  the referrer of the request to your platform - this could be in the HTTP_REFERER header of the request
            string referrer = "http://bing.com/search?q=car";

//  encode the request parameters
            string query = API_URL
                + "?accessToken=" + accessToken
                + "&ip=" + ip
                + "&ua=" + HttpUtility.UrlEncode(ua)
                + "&url=" + HttpUtility.UrlEncode(url)
                + "&referrer=" + HttpUtility.UrlEncode(referrer);

HttpWebRequest request = (HttpWebRequest)WebRequest.Create(query);
            request.Method = "GET";

try
            {
                WebResponse webResponse = request.GetResponse();
                using (Stream webStream = webResponse.GetResponseStream())
                {
                    if (webStream != null)
                    {
                        using (StreamReader responseReader = new StreamReader(webStream))
                        {
                            string response = responseReader.ReadToEnd();
                            Console.Out.WriteLine(response);
                        }
                    }
                }
            }
            catch (Exception e)
            {
                Console.Out.WriteLine(e.Message);
            }
        }
    }
}

Analytics

Get full analytics on your users. The API aggregates data on quality scores, geolocation, demographics, search, device types, devices, campaigns, publishers and much more. Full reporting is available on your users:

Sample Use Cases

Use	Reason
Ads	Do not display ads to invalid users. Keep your reputation as a publisher intact.
Content Optimization	Tailor your content based on a user's geo, demo or device type.
Offers	Base offers on location, search terms, or user's demographic.
Publisher Networks	See which publishers have the best and worst traffic.
Save bandwidth	Why stream videos to bots?

High Volume

The API supports high-volume usage.

Colocation

We support the colocation of our API in order to provide the fastest possible lookups. Contact us for more information.

Signup - Free Trial