Macromeasures API documentation

The Macromeasures API provides access to the demographic and psychographic attributes of users based on their social media presence, as inferred by our proprietary platform. We currently support user lookups by user ID or username for Twitter and Instagram.

You can check the status of our API endpoints at status.macromeasures.com.

If you have any questions, or would like to request an API key, send us an email at hello@macromeasures.com.

Quickstart

If you have an API key, you can make a simple GET request to our API to test it out. Just replace KEY with your API key in the URLs below.

Lookups by user ID

https://api.macromeasures.com/twitter/users.json?key=KEY&ids=15677079,54904679

This will give you the inferred user attributes for the Twitter users @vasunadella and @aircanada, whose Twitter user IDs are 15677079 and 54904679 respectively. You may replace these user IDs with other valid Twitter user IDs of your choosing, separated by commas.

Note that if you request users that haven't been recently requested, the response will show "complete": false initially, and you will need to keep refreshing the page until you see "complete": true.

Looking up Instagram users by user ID is similar:

https://api.macromeasures.com/instagram/users.json?key=KEY&ids=2010731737,212581319

In the above URL, 2010731737 is the Instagram user ID for @vasunadella, and 212581319 is the Instagram user ID for @aircanada. We will return all the data we can infer from the Instagram profiles for those users. Note that the above URL will only work if your API key has been granted access to our Instagram product, which is available upon request.

Lookups by username

https://api.macromeasures.com/twitter/users.json?key=KEY&usernames=tlornewr,aircanada

This will give you the inferred user attributes for the Twitter users @tlornewr and @aircanada. You may replace these usernames with other valid Twitter usernames of your choosing, separated by commas.

Looking up Instagram users by username is similar:

https://api.macromeasures.com/instagram/users.json?key=KEY&usernames=tlornewr,aircanada

We strongly recommend using user IDs rather than usernames wherever possible, as Twitter and Instagram users will often change their usernames. User IDs, on the other hand, are constant for a given user, and so storing and making lookups by user ID will help avoid unexpected behaviour.

Performance and reliability

For optimal performance, we highly recommend reading the rest of the API documentation before integrating the Macromeasures API into your application.

Overview

The API can be accessed over HTTPS, with data returned in JSON format.

The main endpoint for getting user data is the users endpoint, available at

https://api.macromeasures.com/twitter/users.json

or

https://api.macromeasures.com/instagram/users.json

This endpoint requires authentication, and is rate-limited. This is detailed in the next section.

Authentication and rate-limiting

Authentication is handled via API keys. If you've been granted access to our platform, we'll provide you with an API key that you will need to send as a GET parameter when making any requests to our API.

The only endpoint that enforces rate-limiting is the users endpoint. Rate-limiting is done on a per-key basis, based on limits that are set when the key is created. These limits restrict how many users your API key can query, with a lifetime limit restricting how many users can be queried over the lifetime of an API key, and a period limit restricting how many users can be queried in a given period (usually 60 seconds, though this may vary for your key). A lifetime limit of 0 is equivalent to no lifetime limit.

Rate limits for Twitter are applied independently of rate limits for Instagram, and vice versa.

Defining a user query

Because of the asynchronous nature of our API, our definition of what counts as a user query (for rate-limiting purposes) is a bit unintuitive. Notably, you are charged for user queries if and only if you make a request that responds with "complete": true, since no user data is returned when complete is false. Furthermore, since our API can accept multiple user IDs in a single HTTP request, a single API request can often result in multiple user queries, as every user that you request via our API counts as one user query.

Some examples:

  • If you make a request for 100 distinct users, and the complete field in the response has a value of false, that does not count as any queries. (However, as the complete field is false, the response will not contain the requested user data - you will have to keep making the same request until complete shows true.)
  • If you make the same request again a few seconds later, and the response is complete, you will be charged for 100 user queries, irrespective of the validity of each user ID or how much data is inferred for each user.
  • If you make the same request a few seconds later, the response will still be complete (as the users will be cached on our end), and you will be charged for another 100 user queries.
  • If you make a request for 100 users, but one user ID is specified twice, and the response is complete, you will be charged for 99 user queries.
  • If you have 2 scripts running simultaneously, and both scripts request the same user ID and get a complete response, then you will be charged for 2 user queries (one for each script).

If your application requires constantly re-fetching user details from our API, we recommend that you either cache these user details on your end (if potentially stale data is acceptable) or simply opt for an API key with higher limits.

Exceeding rate limits

If you make a request that exceeds either the period rate limit or the lifetime rate limit, you'll receive the following error message:

Rate limit exceeded

and the request will not go through. This will not affect the number of calls you have remaining, it just means that you may need to split your request into smaller pieces, or request a larger API key.

Exceeding lifetime rate limits

Suppose your lifetime limit is 1000 users, and you've already made 995 user queries. A subsequent attempt to query 10 distinct users in a single HTTP request will fail with the Rate limit exceeded error message. However, if you make another request, this time with only 5 distinct users, this request will not exceed the lifetime rate limit (though it may exceed the period rate limit).

If you've hit the lifetime limit for a particular API key, you will not be able to query any more users with that key. In that situation, we would recommend contacting us to get a new key.

Exceeding period rate limits

Suppose your period limit is 50 users per 60 seconds, with no lifetime limit, and you haven't yet made any requests. If your first API request contains 100 distinct user IDs, your request will fail with the Rate limit exceeded error message. However, if you make another request, this time with exactly 50 distinct users, this request will succeed, and when the users are all complete you will be able to retrieve their data. To fetch user data for the remaining 50 users, you just need to wait until the period resets (in this case, this will happen 60 seconds after the initial API request).

Getting rate limits

Suppose your key is example123. You can check the rate limits of your API key using the following endpoint:

https://api.macromeasures.com/limits.json?key=example123

The result would be something like this:

{
    "twitter": {
        "lifetime_limit": 0,
        "lifetime_remaining": 0,
        "period_limit": 100,
        "period_remaining": 95,
        "period_reset": 55
    }
}

This response indicates that the example123 API key has no Twitter lifetime limit, and that you can query 95 more Twitter users in the next 55 seconds. After 55 seconds have elapsed, you will be able to query another 100 Twitter users, whether or not you make more calls in the next 55 seconds (in other words, your period-based limits do not carry over from one period to the next).

The absence of an "instagram" field indicates that the example123 API key does not have access to our Instagram API.

Rate-limiting information is also available via the following response request headers for every successful request to the users endpoint (that is, every request where "error": false):

  • X-RateLimit-LifetimeLimit
  • X-RateLimit-LifetimeRemaining
  • X-RateLimit-PeriodLimit
  • X-RateLimit-PeriodRemaining
  • X-RateLimit-PeriodReset

These response headers behave identically to the fields returned by the /limits.json endpoint, as explained above.

Getting user data

Our API can provide developers with the inferred attributes of any valid Twitter or Instagram user, whether they signed up a year ago or a minute ago. Although we have a sizable contingent of pre-classified users, there will always be users that aren't readily available in our database, who will thus need to be classified on demand. Correspondingly, our API was built for processing users in real time.

The result is an asynchronous API. If you query a user we don't yet have in our database, the response will look like this:

{
    "complete": false,
    "error": false
}

We recommend repeatedly polling the API every 1-2 seconds until the complete field shows true. Classifying a single new user usually takes about a second or two to complete, depending on the current load of our API and the response time of the Twitter or Instagram API. Since our API relies on external APIs, we cannot guarantee a particular response time, but if your requests are taking significantly longer than you would expect, let us know and we'll look into it.

Processing large batches

If you have a large number of users, we suggest making a request with multiple users at a time for maximum throughput. This will be significantly faster than making multiple single-user requests, as the users can then be processed concurrently.

For example, if you need to query 1000 users against our API, making 10 requests of 100 users each might take 2-3 minutes in total, depending on your period limit and our API load. Making 1000 requests of 1 user each might take closer to 20 minutes in total, as this method does not take advantage of concurrent processing and has the added overload of making 1000 HTTP requests.

We typically recommend batches of 50-100 users at a time. Responses from our API are gzipped if they're over 1000 bytes in size, so requests with fewer than 100 users are usually significantly less than a megabyte in size. We don't recommend batches of more than 500 users at a time, as performance tends to degrade with extremely large request sizes.

For optimal performance, batches should be processed sequentially, not using a round-robin method. You should ensure that each batch is finished (indicated by the "complete": true in the response) before moving on to the next one. This ensures that the users are still in the cache when you fetch their data. Using a round-robin strategy is strongly advised against, as our API was not designed for that type of usage.

Supported attributes

We can return the following attributes for each user:

  • gender
  • interests
  • language
  • location
  • platform
  • type

See below for an explanation of how each attribute is determined and the expected format of the response.

Note that all attributes will have a "confirmed" field (a boolean, indicating whether the attribute has been manually reviewed by our staff) and an "updated" field (a UNIX timestamp indicating when the attribute was last updated), which will not be shown in the example responses below.

Gender

This attribute contains the inferred gender of the user.

Example response:

{
    "label": "M"
}

This attribute has only one field, "label", whose value must be "M" for male, "F" for female, or "?". We use a variety of signals to infer gender, including the name, username, bio, profile URL, tweets/posts, and network of a user.

The label "?" is used for all non-personal accounts. It is also used for any user whose gender we cannot infer with reasonable confidence as well as for users who explicitly do not identify as either male or female.

Confidence scores for gender are currently not available. If confidence scores would be useful for your application, let us know and we'll make it a priority.

Interests

This attribute contains a structured list of psychographic characteristics that we've inferred about the user, organised in a tree structure in which branches are of arbitrary depths and each interest can have multiple parents. This structure contains over 4000 distinct interests, ranging from likely life stage characters (e.g., "Student", or "Parent", or "Married") to past and present TV shows (e.g., "Scream Queens" or "Breaking Bad") to brands (e.g., "Whole Foods" or "Urban Outfitters") to celebrities of all sorts (e.g., "Tiger Woods" or "Alex from Target") to print and digital publications (e.g., "PopSugar" or "Scientific American") to general hobbies and interests (e.g., "Golf", or "Korean pop music", or "Frozen yogurt").

We identify these characteristics by analysing a user's content and network against a database of interest-indicative entities, which we keep up-to-date using supervised machine learning. The interests themselves are manually chosen by our staff, based on what we think would be useful to our customers as well the feasibility of detecting that interest through social data.

Our interest ontology is loosely inspired by IAB's Quality Assurance Guidelines Taxonomy, but carefully crafted to reflect the nuances of social data as well as to include all the different types of interests we want to support (brands, TV shows, celebrities, etc). It's also highly structured to ensure that each interest is placed in context, while being flexible enough to support a wide variety of interests. For example, "Naomi Campbell", an English fashion model, will fall under the "Fashion models" interest, which itself will fall under "Style and fashion". Similarly, "Florida Gators", which is the name for the athletics teams of University of Florida, will fall under both "University of Florida" and "Southeastern Conference", which is the athletic conference in which the Florida Gators compete. This structure makes it easier to both understand individual interests and to query within the ontology.

Since this attribute contains such a variety of different interests, the response format is a little more complex than the others. To help explain the format, we've included an example response for a user who is interested in baseball:

{
    "all": {
        "55afc38392cffb786d83f795": {
            "category": "default",
            "name": "Sports",
            "level": "High",
            "score": 4,
            "parents": [],
            "display": "Sports"
        },
        "5457c85bd4ac147ca1acdd55": {
            "category": "default",
            "name": "Baseball",
            "level": "High",
            "score": 4,
            "parents": [
                "55afc38392cffb786d83f795"
            ],
            "display": "Baseball"
        },
        "55afc38492cffb786d83f7eb": {
            "category": "default",
            "name": "Major League Baseball",
            "level": "High",
            "score": 4,
            "parents": [
                "5457c85bd4ac147ca1acdd55"
            ],
            "display": "Major League Baseball"
        },
        "55f0b8e392cffb368e8828cb": {
            "category": "team",
            "name": "New York Yankees",
            "level": "Medium",
            "score": 2,
            "parents": [
                "55afc38492cffb786d83f7eb"
            ],
            "display": "New York Yankees (team)"
        },
        "55f0b8e392cffb368e8828cb": {
            "category": "team",
            "name": "Los Angeles Dodgers",
            "level": "Low",
            "score": 1,
            "parents": [
                "55afc38492cffb786d83f7eb"
            ],
            "display": "Los Angeles Dodgers (team)"
        }
    }
}

This attribute has one field, "all", which contains a mapping from interest ID (that we use internally) to a dictionary containing data for each interest. This dictionary consists of the following fields:

  • category: A short word used to quickly add context to an interest, which will be one of the following:
    • artist: A musical group or celebrity known primarily for the music they make. Examples: "Taylor Swift", "One Direction", "Owl City".
    • celebrity: Any well-known person, living or dead, who doesn't fit better in another category. Includes politicians, actors, models, athletes, and internet celebrities. Examples: "Marc Andreessen", "Benedict Cumberbatch", "Alex From Target".
    • show: A current or past television show. Examples: "One Tree Hill", "Arrested Development", "Pretty Little Liars".
    • universe: A fictional universe that is not limited to a television show. Examples: "The Lord of the Rings", "The Hunger Games", "My Little Pony".
    • publisher: A producer of content. Can be a website, magazine, and/or television network. Examples: "ABC Family", "Reuters", "Vogue Magazine".
    • community: An online community or platform with a significant social element. Examples: "Ask.fm", "Yelp", "Bodybuilding.com".
    • institution: An educational institution. Examples: "Boston College", "Yale University", "Massachusetts Institute of Technology".
    • game: A video or board game. Examples: "League of Legends", "Minecraft", "Settlers of Catan".
    • place: A physical place. Examples: "New York City", "Costa Rica", "Los Angeles International Airport".
    • team: A sports team. Includes collegiate teams. Examples: "Miami Heat", "Manchester United F.C.", "Florida Gators".
    • nonprofit: A non-profit organisation. Includes non-governmental organisations and institutions. Examples: "Apache Software Foundation", "Doctors Without Borders", "WikiLeaks".
    • event: An event or type of event. Examples: "New York Fashion Week", "San Diego Comic-Con", "The Academy Awards".
    • brand: Any sort of brand or corporation that doesn't fit better in another category. Examples: "United Airlines", "Google", "Prada".
    • trait: A characteristic that a person can use to identify themselves. This category is used to specify more targeted interests and attributes, including life stages. Examples: "Ballet dancer", "High school student", "Pilot".
    • default: Anything that doesn't fit better in another category. Examples: "3D printing", "Yoga", "NoSQL databases".
  • name: A human-readable name for the interest. Should be unique for the given category, but may not be globally unique among all categories.
  • level: A human-readable indication of the interest level, based on the number of signals we detect for this specific interest. Can be "Low", "Medium", or "High".
  • score: A numerical (integer) indication of the interest level. This is directly related to the "level" (above) as follows: a score of 1 is "Low"; a score of 2 or 3 is "Medium"; a score of 4 or above is "High". Note that the interest level of any particular interest adds to the interest level of any parent interests it may have. In the example above, the score of 2 for "New York Yankees" and the score of 1 for "Los Angeles Dodgers" both contributed to the score of 4 for "Major League Baseball", which would have had a score of 1 otherwise.
  • parents: A list of internally-used IDs for the interests that are direct parents of the given interest. Data for each parent will be present in the mapping in the "all" field, to ensure that a partial interest hierarchy can be reconstructed for any individual user. If the parents list is empty for a given interest, then the interest should be thought of as a root interest.
  • display: A combination of the name and the category in parentheses (if the category is not "default"). This should be unique for each interest, but should not be treated as a constant identifier, since names and categories may change as we improve our ontology. If you need a unique identifier, use the 24-character interest ID, which should not change.

We're constantly adding new interests as they show up in popular culture or by request, so if you would like an interest that we don't currently support, we'll be happy to look into it.

Language

This attribute contains the inferred languages used by the user.

Example response:

{
    "recent": [
        {
            "iso_code": "en",
            "name": "English",
            "timestamp": 1427730693
        },
        {
            "iso_code": "fr",
            "name": "French",
            "timestamp": 1427724421
        }
    ],
    "primary": {
        "iso_code": "en",
        "name": "English",
    }
}

The "recent" field contains a list of languages detected in the user's recent tweets, for Twitter users, or post captions, for Instagram users. These recent languages are associated with the UNIX timestamp of their last detected usage, and are sorted with the most recent timestamps first. If the user is protected or does not have enough tweets or posts, the "recent" field will be empty.

The "primary" field contains a single language that we have identified as the user's primary language, based on the proportion of tweets/posts identified as using that language. If we are unable to identify the language of the user's tweets/posts, we will look at the accounts that the user is following as well as the content in the user's profile.

Each language comes with a human-readable name and its corresponding ISO 639-1 code. Language locales are not supported because they are better represented by the location field.

Location

This attribute contains the user's inferred primary location. This is inferred using the user's profile content and network to the most precise degree of granularity possible -- either "city", or "subdivision", or "country", or "unknown".

Example response for a user in New York City (with city-level granularity):

{
    "primary": {
        "city": "New York",
        "country": {
            "code": "US",
            "name": "United States"
        },
        "display": "New York, New York, United States",
        "granularity": "city",
        "latitude": 40.71427,
        "longitude": -74.00597,
        "subdivision": {
            "code": "NY",
            "name": "New York"
        }
    }
}

Example response for a user in New York state (with subdivision-level granularity):

{
    "primary": {
        "city": null,
        "country": {
            "code": "US",
            "name": "United States"
        },
        "display": "New York, United States",
        "granularity": "subdivision",
        "latitude": 43.00035,
        "longitude": -75.4999,
        "subdivision": {
            "code": "NY",
            "name": "New York"
        }
    }
}

Example response for a user in the United States (with country-level granularity):

{
    "primary": {
        "city": null,
        "country": {
            "code": "US",
            "name": "United States"
        },
        "display": "United States",
        "granularity": "country",
        "latitude": 39.76,
        "longitude": -98.5,
        "subdivision": null
    }
}

The latitude and longitude values should not be interpreted as the precise location of the user, but rather as an approximation of the user's location at the specified granularity. For example, for the country-level granularity example above, the latitude and longitude values will simply point to a location near the center of the US.

If the location is unknown, the response will look like this:

{
    "primary": {
        "city": null,
        "country": null,
        "display": "Unknown",
        "granularity": "unknown",
        "latitude": null,
        "longitude": null,
        "subdivision": null
    }
}

Platform

This attribute -- only available for Twitter -- contains a list of the devices that the user uses to tweet, as inferred by the "source" field of recent tweets.

Example response for a user who tweets from a computer, an Android device, and an iPhone:

{
    "primary": {
        "name": "Computer"
    },
    "recent": [
        {
            "name": "Android",
            "timestamp": 1408454395
        },
        {
            "name": "Computer",
            "timestamp": 1444062942
        },
        {
            "name": "iPhone",
            "timestamp": 1444325090
        }
    ]
}

The "primary" field contains the name of the user's primary tweeting device, while the "recent" field contains a sorted list of all detected tweeting devices, each identified by name and associated with a UNIX timestamp indicating the most recent usage (with most recent devices listed first).

Possible device names include: Android, Android Tablet, Blackberry, iOS, iPad, iPhone, Mac, Mobile, Windows Phone, Computer. We always return the most specific device that can be confidently inferred.

If the user does not have enough device-indicative tweets, or has a protected account, then the response will look like this:

{
    "primary": {
        "name": "?"
    },
    "recent": []
}

Note that this attribute is only available for Twitter because the Instagram API does not provide the metadata needed to infer this information.

Type

This attribute indicates whether or not we this account is classified as a personal account.

Example response for a personal account:

{
    "personal": true
}

The "personal" field will be true if we classify this account as a personal account and false otherwise. We define an account as being "personal" if: 1) there is one primary user managing the account; 2) it makes sense to assign a gender to the account; 3) the account is a reasonable representation of the person managing it; and 4) the account is not clearly spam or a bot. Note that we do not return gender, location, or interest data for accounts that have been classified as not personal.

Some accounts that we would classify as personal on Twitter include @vasunadella, @dellsystem, @timoreilly. Some accounts that we would classify as not personal include @aircanada, @barackobama (as the account is run by his staff), @homerjsimpson, @newsycombinator, @inspire_us.

Requesting specific attributes

By default, if you make a request to the users endpoint, we will return data for all of the above attributes for each user. If you only wish to get data for particular attributes, you can explicitly specify these attributes using the attributes GET parameter. For example, if you are only interested in the interests and gender attributes, you could make the following request:

https://api.macromeasures.com/twitter/users.json?key=KEY&ids=15677079&attributes=interests,gender

Limiting the attributes to the ones that you need for your application is recommended, especially if you want to decrease the response time or the amount of data sent per request.

Refreshing attributes

By default, if you request a user who has been classified previously, the response will contain the inferred attributes as of the most recent reclassification for that user. For example, if you request gender for @vasunadella, and the gender attribute for this user was last inferred on January 1, 2015, then your response would contain something like this:

{
    "gender": {
        "confirmed": false,
        "label": "M",
        "updated": 1420088400,
    }
}

meaning that the user will not be reclassified, no matter how much time has elapsed since the last classification. This is to ensure speedy responses for the users we already have in our database.

However, if your application requires more up-to-date data, you can force reclassification after a certain number of days on a per-attribute basis. This has a number of advantages, depending on the attribute. As our inference engine is constantly improving, you are likely to receive more accurate and more granular data, and can take advantage of any new TV shows or brands or other interests that have been added since the user was last classified. These cutoffs are specified as GET parameters in a request to the users endpoint, with the key being [attribute]_cutoff and the value being the number of days after which to force reclassification (as an integer).

For example, to request @vasunadella for gender and interests, with the requirements that gender must have been classified in the past 30 days and that interests must have been classified in the past 7 days, you could make the following request:

https://api.macromeasures.com/twitter/users.json?key=KEY&ids=15677079&attributes=gender,interests&interests_cutoff=7&gender_cutoff=30

Enterprise customers can specify a cutoff of 0 to ensure that the user was last classified in the last 60 seconds. For other customers, the minimum cutoff that can be specified is 1 day. Any number that is not a positive integer (or non-negative integer, for enterprise customers) will be ignored.

Note that if an attribute is confirmed (which may occur for type, gender, and location), the reclassification cutoff will be ignored for that attribute, and reclassification will not occur.

Accuracy and limitations

As attributes are inferred algorithmically, we cannot guarantee the accuracy of our results. Although we will only return attribute data for a user if we are reasonably confident of its accuracy, there will always be the occasional user we misgender, or place in the wrong city, or mistakenly treat as personal.

However, our platform is constantly improving, and users are reclassified frequently. You may find that a user with no inferred location one day will have an accurate city-level location the next, as our inference engine improves. You can also force reclassification with attribute cutoffs, if you want to take full advantage of our system.

We currently do not report confidence scores, as we only report attribute data if we are fairly confident about it, and many of our methods do not lend themselves well to confidence scores. There is a confirmed field for each attribute that indicates whether or not the inferred value has been manually reviewed by our staff.

Language coverage

At the moment, our focus is on users who primarily tweet in English. We will return results for users who tweet primarily in other languages, but our accuracy may be lower, and we may not be able to pick up as many interests. We plan to improve our support for French and Spanish and potentially other languages in the future, depending on the requirements of our partners.

Protected users

We do return results for protected users, but since we do not have access to the tweets/posts of these users, our accuracy may be lower. However, as we can access their profile and network information, querying protected users against our API will still return reasonable results most of the time.

Sample response (user ID)

Below you will find an example API response for all the attributes of 3 Twitter users, when fetched by user ID: @vasunadella (user ID: 15677079), @aircanada (user ID: 54904679), and an invalid user (user ID: 1).

Note that this example response is provided for demonstration purposes only and may not be an up-to-date reflection of our interest hierarchy or the data we have on these users.

URL:

https://api.macromeasures.com/twitter/users.json?key=KEY&ids=15677079,54904679,1

Response:

{
    "labels": {
        "1": {
            "valid": false
        }, 
        "15677079": {
            "interests": {
                "all": {
                    "55afc38492cffb786d83f7f0": {
                        "category": "default", 
                        "name": "American politics", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "5457c85bd4ac147c81e8b493"
                        ], 
                        "display": "American politics"
                    }, 
                    "5457c85ad4ac147c59c0ca58": {
                        "category": "default", 
                        "name": "Marketing", 
                        "level": "High", 
                        "score": 6, 
                        "parents": [
                            "55afc38492cffb786d83f7d0"
                        ], 
                        "display": "Marketing"
                    }, 
                    "5460381cd4ac14129e2a921b": {
                        "category": "default", 
                        "name": "Web hosting and domains", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "5457c85bd4ac147cabc75c69"
                        ], 
                        "display": "Web hosting and domains"
                    }, 
                    "55b3c98492cffb11604e584a": {
                        "category": "default", 
                        "name": "Social media", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Social media"
                    }, 
                    "55afc38492cffb786d83f7d0": {
                        "category": "default", 
                        "name": "Business and careers", 
                        "level": "High", 
                        "score": 195, 
                        "parents": [], 
                        "display": "Business and careers"
                    }, 
                    "545ab86fd4ac144b79f8c30a": {
                        "category": "default", 
                        "name": "Web development", 
                        "level": "Medium", 
                        "score": 3, 
                        "parents": [
                            "5457c85bd4ac147cabc75c6a", 
                            "5457c85bd4ac147cabc75c69"
                        ], 
                        "display": "Web development"
                    }, 
                    "55afc38492cffb786d83f7f8": {
                        "category": "default", 
                        "name": "Ice hockey", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38392cffb786d83f795"
                        ], 
                        "display": "Ice hockey"
                    }, 
                    "55afc38792cffb786d83f900": {
                        "category": "default", 
                        "name": "Hobbies and interests", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Hobbies and interests"
                    }, 
                    "55afc38792cffb786d83f924": {
                        "category": "default", 
                        "name": "Causes and activism", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [], 
                        "display": "Causes and activism"
                    }, 
                    "5457c85ad4ac147c59c0ca52": {
                        "category": "default", 
                        "name": "Entrepreneurship", 
                        "level": "High", 
                        "score": 195, 
                        "parents": [
                            "55afc38492cffb786d83f7d0"
                        ], 
                        "display": "Entrepreneurship"
                    }, 
                    "545917ae1e49afb5702688c8": {
                        "category": "show", 
                        "name": "The Daily Show", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38692cffb786d83f8ac"
                        ], 
                        "display": "The Daily Show (show)"
                    }, 
                    "54612b40d4ac14770d4e9f20": {
                        "category": "default", 
                        "name": "Data science", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85bd4ac147cabc75c6a"
                        ], 
                        "display": "Data science"
                    }, 
                    "54781722d4ac148a337e9881": {
                        "category": "default", 
                        "name": "Museums", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38792cffb786d83f900"
                        ], 
                        "display": "Museums"
                    }, 
                    "55be511f92cffb7c68a4b85d": {
                        "category": "brand", 
                        "name": "Simply Measured", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55be4e3992cffb7c68a4b857"
                        ], 
                        "display": "Simply Measured (brand)"
                    }, 
                    "54f65944d4ac14708e560729": {
                        "category": "default", 
                        "name": "Pets", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Pets"
                    }, 
                    "55afc38692cffb786d83f891": {
                        "category": "default", 
                        "name": "Society", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [], 
                        "display": "Society"
                    }, 
                    "55afc38392cffb786d83f7aa": {
                        "category": "default", 
                        "name": "Canadian politics", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85bd4ac147c81e8b493"
                        ], 
                        "display": "Canadian politics"
                    }, 
                    "55afc38792cffb786d83f927": {
                        "category": "brand", 
                        "name": "Spotify", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "54777a97d4ac145258a95e56"
                        ], 
                        "display": "Spotify (brand)"
                    }, 
                    "55afc38592cffb786d83f83d": {
                        "category": "community", 
                        "name": "GitHub", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "5457c85bd4ac147cabc75c6a"
                        ], 
                        "display": "GitHub (community)"
                    }, 
                    "5457c85ad4ac147c59c0ca4f": {
                        "category": "default", 
                        "name": "Business news", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "55afc38392cffb786d83f797", 
                            "55afc38492cffb786d83f7d0"
                        ], 
                        "display": "Business news"
                    }, 
                    "5474cd15d4ac1414b9f7f8b6": {
                        "category": "default", 
                        "name": "Technology conferences", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38592cffb786d83f878"
                        ], 
                        "display": "Technology conferences"
                    }, 
                    "5457c85ad4ac147c59c0ca4d": {
                        "category": "default", 
                        "name": "Advertising", 
                        "level": "High", 
                        "score": 6, 
                        "parents": [
                            "5457c85ad4ac147c59c0ca58"
                        ], 
                        "display": "Advertising"
                    }, 
                    "545aaf3ed4ac149c9d3c1770": {
                        "category": "default", 
                        "name": "Wearable technology", 
                        "level": "Medium", 
                        "score": 3, 
                        "parents": [
                            "55afc38592cffb786d83f856"
                        ], 
                        "display": "Wearable technology"
                    }, 
                    "54777a97d4ac145258a95e56": {
                        "category": "default", 
                        "name": "Music streaming services", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85bd4ac147c8dd12710"
                        ], 
                        "display": "Music streaming services"
                    }, 
                    "5457c85bd4ac147c950ef95c": {
                        "category": "default", 
                        "name": "Reptiles", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "54f65944d4ac14708e560729"
                        ], 
                        "display": "Reptiles"
                    }, 
                    "55afc38792cffb786d83f929": {
                        "category": "default", 
                        "name": "Art", 
                        "level": "High", 
                        "score": 4, 
                        "parents": [], 
                        "display": "Art"
                    }, 
                    "55afc38492cffb786d83f7c3": {
                        "category": "publisher", 
                        "name": "CBS", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "54613f71d4ac14770d4e9f8c"
                        ], 
                        "display": "CBS (publisher)"
                    }, 
                    "55afc38692cffb786d83f8da": {
                        "category": "default", 
                        "name": "Civil rights", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "55afc38692cffb786d83f891", 
                            "55afc38792cffb786d83f924"
                        ], 
                        "display": "Civil rights"
                    }, 
                    "545917b31e49afb5702688c9": {
                        "category": "show", 
                        "name": "The Colbert Report", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38692cffb786d83f8ac"
                        ], 
                        "display": "The Colbert Report (show)"
                    }, 
                    "5457c85bd4ac147cabc75c6a": {
                        "category": "default", 
                        "name": "Software development", 
                        "level": "High", 
                        "score": 15, 
                        "parents": [
                            "55afc38592cffb786d83f846"
                        ], 
                        "display": "Software development"
                    }, 
                    "55b5641892cffb3b194d138d": {
                        "category": "publisher", 
                        "name": "The Economist", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85ad4ac147c59c0ca4f"
                        ], 
                        "display": "The Economist (publisher)"
                    }, 
                    "55afc38592cffb786d83f835": {
                        "category": "default", 
                        "name": "Home and garden", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [], 
                        "display": "Home and garden"
                    }, 
                    "5457c85ad4ac147c61096bf6": {
                        "category": "default", 
                        "name": "Online education", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85ad4ac147c61096bf2"
                        ], 
                        "display": "Online education"
                    }, 
                    "5457c85bd4ac147cabc75c78": {
                        "category": "default", 
                        "name": "Startups", 
                        "level": "High", 
                        "score": 195, 
                        "parents": [
                            "5457c85ad4ac147c59c0ca52"
                        ], 
                        "display": "Startups"
                    }, 
                    "54613f71d4ac14770d4e9f8c": {
                        "category": "default", 
                        "name": "Television", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38692cffb786d83f8a9"
                        ], 
                        "display": "Television"
                    }, 
                    "55afc38692cffb786d83f88e": {
                        "category": "default", 
                        "name": "Government and politics", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [], 
                        "display": "Government and politics"
                    }, 
                    "5457c85ad4ac147c61096bf2": {
                        "category": "default", 
                        "name": "Education", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Education"
                    }, 
                    "544938cad4ac141480335200": {
                        "category": "show", 
                        "name": "CSI", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38492cffb786d83f7c3", 
                            "55afc38692cffb786d83f89c"
                        ], 
                        "display": "CSI (show)"
                    }, 
                    "55afc38692cffb786d83f8dc": {
                        "category": "default", 
                        "name": "Digital rights", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "55afc38692cffb786d83f8da"
                        ], 
                        "display": "Digital rights"
                    }, 
                    "5457c85bd4ac147c99d3f490": {
                        "category": "default", 
                        "name": "Science", 
                        "level": "High", 
                        "score": 4, 
                        "parents": [], 
                        "display": "Science"
                    }, 
                    "5457c85bd4ac147c99d3f491": {
                        "category": "default", 
                        "name": "Space and astronomy", 
                        "level": "High", 
                        "score": 4, 
                        "parents": [
                            "5457c85bd4ac147c99d3f490"
                        ], 
                        "display": "Space and astronomy"
                    }, 
                    "55afc38392cffb786d83f797": {
                        "category": "default", 
                        "name": "News", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [], 
                        "display": "News"
                    }, 
                    "55afc38592cffb786d83f846": {
                        "category": "default", 
                        "name": "Software", 
                        "level": "High", 
                        "score": 15, 
                        "parents": [
                            "5457c85bd4ac147cabc75c7a"
                        ], 
                        "display": "Software"
                    }, 
                    "55afc38892cffb786d83f972": {
                        "category": "publisher", 
                        "name": "TBS", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "54613f71d4ac14770d4e9f8c"
                        ], 
                        "display": "TBS (publisher)"
                    }, 
                    "55afc38792cffb786d83f8e8": {
                        "category": "default", 
                        "name": "Dramas", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "54613f71d4ac14770d4e9f8c"
                        ], 
                        "display": "Dramas"
                    }, 
                    "547a6903d4ac147fec004364": {
                        "category": "default", 
                        "name": "Atheism", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5540642ad2729a2e88e59806"
                        ], 
                        "display": "Atheism"
                    }, 
                    "55afc38592cffb786d83f82e": {
                        "category": "default", 
                        "name": "Comedic shows", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "54613f71d4ac14770d4e9f8c"
                        ], 
                        "display": "Comedic shows"
                    }, 
                    "5478bcabd4ac1436f0a6aba6": {
                        "category": "default", 
                        "name": "Web hosting providers", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "5460381cd4ac14129e2a921b"
                        ], 
                        "display": "Web hosting providers"
                    }, 
                    "5540642ad2729a2e88e59806": {
                        "category": "default", 
                        "name": "Faith and religion", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Faith and religion"
                    }, 
                    "55afc38592cffb786d83f876": {
                        "category": "default", 
                        "name": "Fandoms", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38892cffb786d83f97e"
                        ], 
                        "display": "Fandoms"
                    }, 
                    "55be4e3992cffb7c68a4b857": {
                        "category": "default", 
                        "name": "Social media analytics", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55b3c98492cffb11604e584a"
                        ], 
                        "display": "Social media analytics"
                    }, 
                    "5457c85ad4ac147c798c5585": {
                        "category": "default", 
                        "name": "Design", 
                        "level": "High", 
                        "score": 4, 
                        "parents": [
                            "55afc38792cffb786d83f929"
                        ], 
                        "display": "Design"
                    }, 
                    "55afc38792cffb786d83f933": {
                        "category": "default", 
                        "name": "Indie music", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85bd4ac147c8dd12710"
                        ], 
                        "display": "Indie music"
                    }, 
                    "5457c85bd4ac147cabc75c74": {
                        "category": "default", 
                        "name": "Cybersecurity", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "5457c85bd4ac147cabc75c7a"
                        ], 
                        "display": "Cybersecurity"
                    }, 
                    "55afc38892cffb786d83f98b": {
                        "category": "default", 
                        "name": "Tech literacy programs", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85bd4ac147cabc75c7a"
                        ], 
                        "display": "Tech literacy programs"
                    }, 
                    "55afc38792cffb786d83f8fe": {
                        "category": "brand", 
                        "name": "Rdio", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "54777a97d4ac145258a95e56"
                        ], 
                        "display": "Rdio (brand)"
                    }, 
                    "545ab4bbd4ac1433e87a00a3": {
                        "category": "default", 
                        "name": "Hackathons", 
                        "level": "High", 
                        "score": 45, 
                        "parents": [
                            "55afc38592cffb786d83f878"
                        ], 
                        "display": "Hackathons"
                    }, 
                    "55afc38592cffb786d83f878": {
                        "category": "default", 
                        "name": "Technology events", 
                        "level": "High", 
                        "score": 45, 
                        "parents": [
                            "5457c85bd4ac147cabc75c7a"
                        ], 
                        "display": "Technology events"
                    }, 
                    "545a9406d4ac148e60b38669": {
                        "category": "default", 
                        "name": "Tech industry criticism", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "5457c85bd4ac147cabc75c7a", 
                            "55afc38692cffb786d83f8da"
                        ], 
                        "display": "Tech industry criticism"
                    }, 
                    "54493b1cd4ac141863b6fd61": {
                        "category": "show", 
                        "name": "Conan", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38892cffb786d83f972"
                        ], 
                        "display": "Conan (show)"
                    }, 
                    "5457c85bd4ac147c81e8b493": {
                        "category": "default", 
                        "name": "Politics", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "55afc38692cffb786d83f88e"
                        ], 
                        "display": "Politics"
                    }, 
                    "5457c85ad4ac147c716f5d67": {
                        "category": "default", 
                        "name": "Gaming", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Gaming"
                    }, 
                    "55be528992cffb7c68a4b85f": {
                        "category": "community", 
                        "name": "Twitch.tv", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85ad4ac147c716f5d67"
                        ], 
                        "display": "Twitch.tv (community)"
                    }, 
                    "55afc38892cffb786d83f989": {
                        "category": "brand", 
                        "name": "Tesla Motors", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c811d4ac147c2bf5df58"
                        ], 
                        "display": "Tesla Motors (brand)"
                    }, 
                    "55afc38692cffb786d83f8a9": {
                        "category": "default", 
                        "name": "Television and film", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Television and film"
                    }, 
                    "5457c85bd4ac147ca1acdd64": {
                        "category": "default", 
                        "name": "NHL hockey", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38492cffb786d83f7f8"
                        ], 
                        "display": "NHL hockey"
                    }, 
                    "5457c811d4ac147c2bf5df55": {
                        "category": "default", 
                        "name": "Cars", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38892cffb786d83f985"
                        ], 
                        "display": "Cars"
                    }, 
                    "55afc38892cffb786d83f97e": {
                        "category": "default", 
                        "name": "Popular culture", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Popular culture"
                    }, 
                    "55afc38392cffb786d83f795": {
                        "category": "default", 
                        "name": "Sports", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [], 
                        "display": "Sports"
                    }, 
                    "5457c811d4ac147c2bf5df58": {
                        "category": "default", 
                        "name": "Hybrid and electric vehicles", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c811d4ac147c2bf5df55"
                        ], 
                        "display": "Hybrid and electric vehicles"
                    }, 
                    "5457c85bd4ac147cabc75c7a": {
                        "category": "default", 
                        "name": "Technology", 
                        "level": "High", 
                        "score": 45, 
                        "parents": [], 
                        "display": "Technology"
                    }, 
                    "55afc38592cffb786d83f856": {
                        "category": "default", 
                        "name": "Hardware", 
                        "level": "Medium", 
                        "score": 3, 
                        "parents": [
                            "5457c85bd4ac147cabc75c7a"
                        ], 
                        "display": "Hardware"
                    }, 
                    "55b3df5992cffb12ba79bade": {
                        "category": "default", 
                        "name": "John Green", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38592cffb786d83f876"
                        ], 
                        "display": "John Green"
                    }, 
                    "55afc38892cffb786d83f93c": {
                        "category": "publisher", 
                        "name": "National Public Radio", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "5457c85bd4ac147c8dd12715"
                        ], 
                        "display": "National Public Radio (publisher)"
                    }, 
                    "55afc38692cffb786d83f89c": {
                        "category": "default", 
                        "name": "Crime dramas", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38792cffb786d83f8e8"
                        ], 
                        "display": "Crime dramas"
                    }, 
                    "55afc38892cffb786d83f985": {
                        "category": "default", 
                        "name": "Automotive", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [], 
                        "display": "Automotive"
                    }, 
                    "5457c85bd4ac147cabc75c69": {
                        "category": "default", 
                        "name": "The Internet", 
                        "level": "Medium", 
                        "score": 3, 
                        "parents": [
                            "5457c85bd4ac147cabc75c7a"
                        ], 
                        "display": "The Internet"
                    }, 
                    "5457c85ad4ac147c7da069ed": {
                        "category": "default", 
                        "name": "Interior design", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "55afc38592cffb786d83f835"
                        ], 
                        "display": "Interior design"
                    }, 
                    "5457c85bd4ac147c8dd12715": {
                        "category": "default", 
                        "name": "Talk radio", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38792cffb786d83f900"
                        ], 
                        "display": "Talk radio"
                    }, 
                    "55afc38592cffb786d83f852": {
                        "category": "default", 
                        "name": "Venture capital", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [
                            "5457c85ad4ac147c59c0ca52"
                        ], 
                        "display": "Venture capital"
                    }, 
                    "55afc38692cffb786d83f8ac": {
                        "category": "publisher", 
                        "name": "Comedy Central", 
                        "level": "Low", 
                        "score": 1, 
                        "parents": [
                            "55afc38592cffb786d83f82e"
                        ], 
                        "display": "Comedy Central (publisher)"
                    }, 
                    "5457c85bd4ac147c8dd12710": {
                        "category": "default", 
                        "name": "Music", 
                        "level": "Medium", 
                        "score": 2, 
                        "parents": [], 
                        "display": "Music"
                    }, 
                    "55afc38492cffb786d83f7fe": {
                        "category": "default", 
                        "name": "Startup accelerators", 
                        "level": "High", 
                        "score": 6, 
                        "parents": [
                            "5457c85bd4ac147cabc75c78"
                        ], 
                        "display": "Startup accelerators"
                    }
                }, 
                "updated": 1438826645, 
                "confirmed": false
            }, 
            "language": {
                "confirmed": false, 
                "updated": 1425929354, 
                "primary": {
                    "iso_code": "en", 
                    "name": "English"
                }, 
                "recent": [
                    {
                        "iso_code": "en", 
                        "name": "English", 
                        "timestamp": 1425774336
                    }, 
                    {
                        "iso_code": "fr", 
                        "name": "French", 
                        "timestamp": 1423866011
                    }
                ]
            }, 
            "gender": {
                "confirmed": true, 
                "updated": 1425997953, 
                "label": "M"
            }, 
            "platform": {
                "confirmed": false, 
                "updated": 1422562701, 
                "primary": {
                    "name": "Computer"
                }, 
                "recent": [
                    {
                        "timestamp": 1422474321, 
                        "name": "Android"
                    }, 
                    {
                        "timestamp": 1422500805, 
                        "name": "Computer"
                    }
                ]
            }, 
            "valid": true, 
            "location": {
                "confirmed": true, 
                "updated": 1430079427, 
                "primary": {
                    "city": "Montreal", 
                    "subdivision": {
                        "code": "10", 
                        "name": "Quebec"
                    }, 
                    "country": {
                        "code": "CA", 
                        "name": "Canada"
                    }, 
                    "longitude": -73.58781, 
                    "granularity": "city", 
                    "latitude": 45.50884, 
                    "display": "Montreal, Quebec, Canada"
                }
            }, 
            "type": {
                "personal": true, 
                "confirmed": true, 
                "updated": 1422374568
            }
        }, 
        "54904679": {
            "interests": {
                "all": {}, 
                "updated": 1440796812, 
                "confirmed": false
            }, 
            "language": {
                "confirmed": false, 
                "updated": 1427714471, 
                "primary": {
                    "iso_code": "en", 
                    "name": "English"
                }, 
                "recent": [
                    {
                        "iso_code": "en", 
                        "name": "English", 
                        "timestamp": 1427730693
                    }
                ]
            }, 
            "gender": {
                "confirmed": true, 
                "updated": 1413472949, 
                "label": "?"
            }, 
            "platform": {
                "confirmed": false, 
                "updated": 1422271145, 
                "primary": {
                    "name": "?"
                }, 
                "recent": []
            }, 
            "valid": true, 
            "location": {
                "confirmed": true, 
                "updated": 1419138281, 
                "primary": {
                    "city": null, 
                    "subdivision": null, 
                    "country": null, 
                    "longitude": null, 
                    "granularity": "unknown", 
                    "latitude": null, 
                    "display": "Unknown"
                }
            }, 
            "type": {
                "personal": false, 
                "confirmed": true, 
                "updated": 1425926012
            }
        }
    }, 
    "complete": true, 
    "error": false
}

Sample response (username)

Below you will find an example API response for all the attributes of 3 Twitter users, when fetched by username: @tlornewr, @aircanada, and an invalid user.

Note that this example response is provided for demonstration purposes only and may not be an up-to-date reflection of our interest hierarchy or the data we have on these users.

URL:

https://api.macromeasures.com/twitter/users.json?key=KEY&usernames=tlornewr,aircanada,notavalidusername

Response:

{
  "complete": true, 
  "error": false, 
  "labels": {
    "aircanada": {
      "gender": {
        "confirmed": true, 
        "label": "?", 
        "updated": 1413472949
      }, 
      "interests": {
        "all": {}, 
        "confirmed": false, 
        "updated": 1462851329
      }, 
      "language": {
        "confirmed": false, 
        "primary": {
          "iso_code": "en", 
          "name": "English"
        }, 
        "recent": [
          {
            "iso_code": "en", 
            "name": "English", 
            "timestamp": 1462848810
          }, 
          {
            "iso_code": "fr", 
            "name": "French", 
            "timestamp": 1462843048
          }
        ], 
        "updated": 1462851329
      }, 
      "location": {
        "confirmed": true, 
        "primary": {
          "city": null, 
          "country": null, 
          "display": "Unknown", 
          "granularity": "unknown", 
          "latitude": null, 
          "longitude": null, 
          "subdivision": null
        }, 
        "updated": 1419138281
      }, 
      "platform": {
        "confirmed": false, 
        "primary": {
          "name": "Computer"
        }, 
        "recent": [
          {
            "name": "Computer", 
            "timestamp": 1442603813
          }
        ], 
        "updated": 1462851329
      }, 
      "type": {
        "confirmed": true, 
        "personal": false, 
        "updated": 1425926012
      }, 
      "valid": true
    }, 
    "notavalidusername": {
      "valid": false
    }, 
    "tlornewr": {
      "gender": {
        "confirmed": true, 
        "label": "M", 
        "updated": 1438044706
      }, 
      "interests": {
        "all": {
          "54493b73d4ac1418c2030519": {
            "category": "show", 
            "display": "Silicon Valley (show)", 
            "level": "Medium", 
            "name": "Silicon Valley", 
            "parents": [
              "55afc38392cffb786d83f7a6", 
              "55afc38592cffb786d83f82e"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "5457c85ad4ac147c55ac2ddb": {
            "category": "default", 
            "display": "Books", 
            "level": "Medium", 
            "name": "Books", 
            "parents": [
              "55afc38492cffb786d83f7e8"
            ], 
            "score": 3, 
            "useful": true
          }, 
          "5457c85ad4ac147c59c0ca4d": {
            "category": "default", 
            "display": "Advertising", 
            "level": "Low", 
            "name": "Advertising", 
            "parents": [
              "5457c85ad4ac147c59c0ca58"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5457c85ad4ac147c59c0ca4f": {
            "category": "default", 
            "display": "Business news", 
            "level": "Low", 
            "name": "Business news", 
            "parents": [
              "55afc38392cffb786d83f797", 
              "55afc38492cffb786d83f7d0"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5457c85ad4ac147c59c0ca52": {
            "category": "default", 
            "display": "Entrepreneurship", 
            "level": "High", 
            "name": "Entrepreneurship", 
            "parents": [
              "55afc38492cffb786d83f7d0"
            ], 
            "score": 21, 
            "useful": true
          }, 
          "5457c85ad4ac147c59c0ca58": {
            "category": "default", 
            "display": "Marketing", 
            "level": "High", 
            "name": "Marketing", 
            "parents": [
              "55afc38492cffb786d83f7d0"
            ], 
            "score": 7, 
            "useful": true
          }, 
          "5457c85ad4ac147c61096bf2": {
            "category": "default", 
            "display": "Education", 
            "level": "High", 
            "name": "Education", 
            "parents": [], 
            "score": 4, 
            "useful": true
          }, 
          "5457c85ad4ac147c798c5587": {
            "category": "default", 
            "display": "Exercise and fitness", 
            "level": "Low", 
            "name": "Exercise and fitness", 
            "parents": [
              "55afc38792cffb786d83f900"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5457c85bd4ac147c81e8b493": {
            "category": "default", 
            "display": "Politics", 
            "level": "Medium", 
            "name": "Politics", 
            "parents": [
              "55afc38692cffb786d83f88e"
            ], 
            "score": 3, 
            "useful": true
          }, 
          "5457c85bd4ac147c8dd1270a": {
            "category": "default", 
            "display": "Electronic music", 
            "level": "Medium", 
            "name": "Electronic music", 
            "parents": [
              "5457c85bd4ac147c8dd12710"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "5457c85bd4ac147c8dd12710": {
            "category": "default", 
            "display": "Music", 
            "level": "Medium", 
            "name": "Music", 
            "parents": [], 
            "score": 3, 
            "useful": true
          }, 
          "5457c85bd4ac147c91c9655a": {
            "category": "default", 
            "display": "Wealth and asset management", 
            "level": "Low", 
            "name": "Wealth and asset management", 
            "parents": [
              "55afc38492cffb786d83f7d0", 
              "55afc38892cffb786d83f94c"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5457c85bd4ac147c99d3f48f": {
            "category": "default", 
            "display": "Physics", 
            "level": "Low", 
            "name": "Physics", 
            "parents": [
              "5457c85bd4ac147c99d3f490"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5457c85bd4ac147c99d3f490": {
            "category": "default", 
            "display": "Science", 
            "level": "High", 
            "name": "Science", 
            "parents": [], 
            "score": 5, 
            "useful": true
          }, 
          "5457c85bd4ac147c99d3f491": {
            "category": "default", 
            "display": "Space and astronomy", 
            "level": "High", 
            "name": "Space and astronomy", 
            "parents": [
              "5457c85bd4ac147c99d3f490"
            ], 
            "score": 4, 
            "useful": true
          }, 
          "5457c85bd4ac147cabc75c69": {
            "category": "default", 
            "display": "The Internet", 
            "level": "High", 
            "name": "The Internet", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 11, 
            "useful": false
          }, 
          "5457c85bd4ac147cabc75c6a": {
            "category": "default", 
            "display": "Software development", 
            "level": "High", 
            "name": "Software development", 
            "parents": [
              "55afc38592cffb786d83f846"
            ], 
            "score": 50, 
            "useful": true
          }, 
          "5457c85bd4ac147cabc75c6d": {
            "category": "default", 
            "display": "Databases", 
            "level": "Medium", 
            "name": "Databases", 
            "parents": [
              "55afc38592cffb786d83f846"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "5457c85bd4ac147cabc75c73": {
            "category": "default", 
            "display": "Mobile devices", 
            "level": "Low", 
            "name": "Mobile devices", 
            "parents": [
              "55afc38592cffb786d83f856"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5457c85bd4ac147cabc75c78": {
            "category": "default", 
            "display": "Startups", 
            "level": "High", 
            "name": "Startups", 
            "parents": [
              "5457c85ad4ac147c59c0ca52"
            ], 
            "score": 16, 
            "useful": true
          }, 
          "5457c85bd4ac147cabc75c7a": {
            "category": "default", 
            "display": "Technology", 
            "level": "High", 
            "name": "Technology", 
            "parents": [], 
            "score": 125, 
            "useful": true
          }, 
          "5457c85cd4ac147caf35b7a5": {
            "category": "default", 
            "display": "Air travel", 
            "level": "High", 
            "name": "Air travel", 
            "parents": [
              "5457c85cd4ac147caf35b7bd"
            ], 
            "score": 13, 
            "useful": true
          }, 
          "5457c85cd4ac147caf35b7b8": {
            "category": "default", 
            "display": "Luxury travel", 
            "level": "High", 
            "name": "Luxury travel", 
            "parents": [
              "5457c85cd4ac147caf35b7bd"
            ], 
            "score": 8, 
            "useful": true
          }, 
          "5457c85cd4ac147caf35b7bd": {
            "category": "default", 
            "display": "Travel", 
            "level": "High", 
            "name": "Travel", 
            "parents": [], 
            "score": 21, 
            "useful": true
          }, 
          "545a9406d4ac148e60b38669": {
            "category": "default", 
            "display": "Tech industry criticism", 
            "level": "High", 
            "name": "Tech industry criticism", 
            "parents": [
              "5457c85bd4ac147cabc75c7a", 
              "55afc38692cffb786d83f8da"
            ], 
            "score": 40, 
            "useful": true
          }, 
          "545a9eb3d4ac1497f6f4455a": {
            "category": "default", 
            "display": "Coffee", 
            "level": "Low", 
            "name": "Coffee", 
            "parents": [
              "55afc38792cffb786d83f8ed"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "545ab48fd4ac1433e87a00a2": {
            "category": "default", 
            "display": "Crossfit", 
            "level": "Low", 
            "name": "Crossfit", 
            "parents": [
              "5457c85ad4ac147c798c5587"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "545ab4bbd4ac1433e87a00a3": {
            "category": "default", 
            "display": "Hackathons", 
            "level": "High", 
            "name": "Hackathons", 
            "parents": [
              "55afc38592cffb786d83f878"
            ], 
            "score": 6, 
            "useful": true
          }, 
          "545ab86fd4ac144b79f8c30a": {
            "category": "default", 
            "display": "Web development", 
            "level": "Medium", 
            "name": "Web development", 
            "parents": [
              "5457c85bd4ac147cabc75c6a", 
              "5457c85bd4ac147cabc75c69"
            ], 
            "score": 3, 
            "useful": true
          }, 
          "54601629d4ac1482f7849f4c": {
            "category": "default", 
            "display": "Cryptocurrency", 
            "level": "High", 
            "name": "Cryptocurrency", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 5, 
            "useful": true
          }, 
          "5460381cd4ac14129e2a921b": {
            "category": "default", 
            "display": "Web hosting and domains", 
            "level": "High", 
            "name": "Web hosting and domains", 
            "parents": [
              "5457c85bd4ac147cabc75c69"
            ], 
            "score": 7, 
            "useful": true
          }, 
          "546129ded4ac14770d4e9f1c": {
            "category": "brand", 
            "display": "Apple (brand)", 
            "level": "Low", 
            "name": "Apple", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "54613f71d4ac14770d4e9f8c": {
            "category": "default", 
            "display": "Television", 
            "level": "Medium", 
            "name": "Television", 
            "parents": [
              "55afc38692cffb786d83f8a9"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "54737fd2d4ac1436036b21bf": {
            "category": "default", 
            "display": "Travel hacking", 
            "level": "Medium", 
            "name": "Travel hacking", 
            "parents": [
              "5457c85cd4ac147caf35b7a5"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "5474cd15d4ac1414b9f7f8b6": {
            "category": "default", 
            "display": "Technology conferences", 
            "level": "Low", 
            "name": "Technology conferences", 
            "parents": [
              "55afc38592cffb786d83f878"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5476aca7d4ac14828c4b922e": {
            "category": "default", 
            "display": "Feminism", 
            "level": "High", 
            "name": "Feminism", 
            "parents": [
              "55afc38692cffb786d83f8da"
            ], 
            "score": 5, 
            "useful": true
          }, 
          "5478bcabd4ac1436f0a6aba6": {
            "category": "default", 
            "display": "Web hosting providers", 
            "level": "High", 
            "name": "Web hosting providers", 
            "parents": [
              "5460381cd4ac14129e2a921b"
            ], 
            "score": 6, 
            "useful": true
          }, 
          "547a3869d4ac149f0a2a62d0": {
            "category": "default", 
            "display": "Woodworking", 
            "level": "Low", 
            "name": "Woodworking", 
            "parents": [
              "55afc38792cffb786d83f900"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "547e5011d4ac142b50150fda": {
            "category": "default", 
            "display": "Credit cards", 
            "level": "Medium", 
            "name": "Credit cards", 
            "parents": [
              "55afc38592cffb786d83f884"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "54b84e3bd4ac144e0fa2a0c5": {
            "category": "default", 
            "display": "System administration", 
            "level": "High", 
            "name": "System administration", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 4, 
            "useful": true
          }, 
          "54de2d7ed4ac143516003770": {
            "category": "default", 
            "display": "Emoji", 
            "level": "High", 
            "name": "Emoji", 
            "parents": [
              "55afc38892cffb786d83f97e"
            ], 
            "score": 6, 
            "useful": false
          }, 
          "54ff57ded4ac141a8c876be9": {
            "category": "default", 
            "display": "Internet celebrities", 
            "level": "Low", 
            "name": "Internet celebrities", 
            "parents": [
              "55afc38892cffb786d83f97e"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38392cffb786d83f791": {
            "category": "community", 
            "display": "Flyertalk (community)", 
            "level": "Low", 
            "name": "Flyertalk", 
            "parents": [
              "54737fd2d4ac1436036b21bf"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38392cffb786d83f797": {
            "category": "default", 
            "display": "News", 
            "level": "Low", 
            "name": "News", 
            "parents": [], 
            "score": 1, 
            "useful": false
          }, 
          "55afc38392cffb786d83f79b": {
            "category": "default", 
            "display": "YouTubers", 
            "level": "Low", 
            "name": "YouTubers", 
            "parents": [
              "54ff57ded4ac141a8c876be9", 
              "55dccf2c92cffb0d3e808059"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38392cffb786d83f79d": {
            "category": "brand", 
            "display": "Star Alliance (brand)", 
            "level": "Medium", 
            "name": "Star Alliance", 
            "parents": [
              "5457c85cd4ac147caf35b7a5"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38392cffb786d83f7a6": {
            "category": "publisher", 
            "display": "HBO (publisher)", 
            "level": "Medium", 
            "name": "HBO", 
            "parents": [
              "54613f71d4ac14770d4e9f8c"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38392cffb786d83f7ad": {
            "category": "default", 
            "display": "NoSQL databases", 
            "level": "Medium", 
            "name": "NoSQL databases", 
            "parents": [
              "5457c85bd4ac147cabc75c6d"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38492cffb786d83f7be": {
            "category": "default", 
            "display": "DevOps", 
            "level": "Medium", 
            "name": "DevOps", 
            "parents": [
              "54b84e3bd4ac144e0fa2a0c5", 
              "5457c85bd4ac147cabc75c6a"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38492cffb786d83f7d0": {
            "category": "default", 
            "display": "Business and careers", 
            "level": "High", 
            "name": "Business and careers", 
            "parents": [], 
            "score": 30, 
            "useful": false
          }, 
          "55afc38492cffb786d83f7e4": {
            "category": "place", 
            "display": "New York City (place)", 
            "level": "High", 
            "name": "New York City", 
            "parents": [
              "5637a02e92cffb1ad847f934"
            ], 
            "score": 4, 
            "useful": true
          }, 
          "55afc38492cffb786d83f7e7": {
            "category": "brand", 
            "display": "oneworld (brand)", 
            "level": "High", 
            "name": "oneworld", 
            "parents": [
              "5457c85cd4ac147caf35b7a5"
            ], 
            "score": 7, 
            "useful": true
          }, 
          "55afc38492cffb786d83f7e8": {
            "category": "default", 
            "display": "Books and publications", 
            "level": "Medium", 
            "name": "Books and publications", 
            "parents": [], 
            "score": 3, 
            "useful": false
          }, 
          "55afc38492cffb786d83f7ed": {
            "category": "default", 
            "display": "Higher education", 
            "level": "High", 
            "name": "Higher education", 
            "parents": [
              "5457c85ad4ac147c61096bf2"
            ], 
            "score": 4, 
            "useful": true
          }, 
          "55afc38492cffb786d83f7f0": {
            "category": "default", 
            "display": "American politics", 
            "level": "Low", 
            "name": "American politics", 
            "parents": [
              "5457c85bd4ac147c81e8b493"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38492cffb786d83f7fe": {
            "category": "default", 
            "display": "Startup accelerators", 
            "level": "High", 
            "name": "Startup accelerators", 
            "parents": [
              "5457c85bd4ac147cabc75c78"
            ], 
            "score": 8, 
            "useful": true
          }, 
          "55afc38492cffb786d83f803": {
            "category": "brand", 
            "display": "American Express (brand)", 
            "level": "Medium", 
            "name": "American Express", 
            "parents": [
              "547e5011d4ac142b50150fda"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38492cffb786d83f806": {
            "category": "brand", 
            "display": "Nespresso (brand)", 
            "level": "Low", 
            "name": "Nespresso", 
            "parents": [
              "545a9eb3d4ac1497f6f4455a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38492cffb786d83f807": {
            "category": "brand", 
            "display": "Amazon Web Services (brand)", 
            "level": "Medium", 
            "name": "Amazon Web Services", 
            "parents": [
              "55afc38792cffb786d83f903", 
              "5478bcabd4ac1436f0a6aba6"
            ], 
            "score": 3, 
            "useful": true
          }, 
          "55afc38492cffb786d83f811": {
            "category": "default", 
            "display": "Ridesharing mobile apps", 
            "level": "Low", 
            "name": "Ridesharing mobile apps", 
            "parents": [
              "5457c85bd4ac147cabc75c73"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38492cffb786d83f822": {
            "category": "brand", 
            "display": "Uber (brand)", 
            "level": "Low", 
            "name": "Uber", 
            "parents": [
              "55afc38492cffb786d83f811"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38592cffb786d83f82e": {
            "category": "default", 
            "display": "Comedic shows", 
            "level": "Medium", 
            "name": "Comedic shows", 
            "parents": [
              "54613f71d4ac14770d4e9f8c"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38592cffb786d83f835": {
            "category": "default", 
            "display": "Home and garden", 
            "level": "Low", 
            "name": "Home and garden", 
            "parents": [], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38592cffb786d83f83d": {
            "category": "community", 
            "display": "GitHub (community)", 
            "level": "Low", 
            "name": "GitHub", 
            "parents": [
              "5457c85bd4ac147cabc75c6a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38592cffb786d83f83e": {
            "category": "place", 
            "display": "United States (place)", 
            "level": "High", 
            "name": "United States", 
            "parents": [
              "55afc38892cffb786d83f94e"
            ], 
            "score": 4, 
            "useful": false
          }, 
          "55afc38592cffb786d83f846": {
            "category": "default", 
            "display": "Software", 
            "level": "High", 
            "name": "Software", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 52, 
            "useful": false
          }, 
          "55afc38592cffb786d83f852": {
            "category": "default", 
            "display": "Venture capital", 
            "level": "High", 
            "name": "Venture capital", 
            "parents": [
              "5457c85ad4ac147c59c0ca52"
            ], 
            "score": 4, 
            "useful": true
          }, 
          "55afc38592cffb786d83f856": {
            "category": "default", 
            "display": "Hardware", 
            "level": "Low", 
            "name": "Hardware", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 1, 
            "useful": false
          }, 
          "55afc38592cffb786d83f86d": {
            "category": "default", 
            "display": "Electronic dance music", 
            "level": "Medium", 
            "name": "Electronic dance music", 
            "parents": [
              "5457c85bd4ac147c8dd1270a"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38592cffb786d83f876": {
            "category": "default", 
            "display": "Fandoms", 
            "level": "Low", 
            "name": "Fandoms", 
            "parents": [
              "55afc38892cffb786d83f97e"
            ], 
            "score": 1, 
            "useful": false
          }, 
          "55afc38592cffb786d83f878": {
            "category": "default", 
            "display": "Technology events", 
            "level": "High", 
            "name": "Technology events", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 7, 
            "useful": true
          }, 
          "55afc38592cffb786d83f884": {
            "category": "default", 
            "display": "Financial products", 
            "level": "Medium", 
            "name": "Financial products", 
            "parents": [
              "55afc38892cffb786d83f94c"
            ], 
            "score": 2, 
            "useful": false
          }, 
          "55afc38692cffb786d83f88a": {
            "category": "default", 
            "display": "Actors", 
            "level": "Low", 
            "name": "Actors", 
            "parents": [
              "55afc38692cffb786d83f8a9"
            ], 
            "score": 1, 
            "useful": false
          }, 
          "55afc38692cffb786d83f88e": {
            "category": "default", 
            "display": "Government and politics", 
            "level": "Medium", 
            "name": "Government and politics", 
            "parents": [], 
            "score": 3, 
            "useful": false
          }, 
          "55afc38692cffb786d83f891": {
            "category": "default", 
            "display": "Society", 
            "level": "High", 
            "name": "Society", 
            "parents": [], 
            "score": 46, 
            "useful": false
          }, 
          "55afc38692cffb786d83f8a9": {
            "category": "default", 
            "display": "Television and film", 
            "level": "Medium", 
            "name": "Television and film", 
            "parents": [], 
            "score": 3, 
            "useful": false
          }, 
          "55afc38692cffb786d83f8da": {
            "category": "default", 
            "display": "Civil rights", 
            "level": "High", 
            "name": "Civil rights", 
            "parents": [
              "55afc38692cffb786d83f891", 
              "55afc38792cffb786d83f924"
            ], 
            "score": 46, 
            "useful": true
          }, 
          "55afc38692cffb786d83f8dc": {
            "category": "default", 
            "display": "Digital rights", 
            "level": "Low", 
            "name": "Digital rights", 
            "parents": [
              "55afc38692cffb786d83f8da"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38792cffb786d83f8ed": {
            "category": "default", 
            "display": "Drinks", 
            "level": "Low", 
            "name": "Drinks", 
            "parents": [
              "55afc38792cffb786d83f91a"
            ], 
            "score": 1, 
            "useful": false
          }, 
          "55afc38792cffb786d83f8f6": {
            "category": "default", 
            "display": "Ruby programming", 
            "level": "High", 
            "name": "Ruby programming", 
            "parents": [
              "5457c85bd4ac147cabc75c6a"
            ], 
            "score": 4, 
            "useful": true
          }, 
          "55afc38792cffb786d83f900": {
            "category": "default", 
            "display": "Hobbies and interests", 
            "level": "Medium", 
            "name": "Hobbies and interests", 
            "parents": [], 
            "score": 2, 
            "useful": false
          }, 
          "55afc38792cffb786d83f903": {
            "category": "brand", 
            "display": "Amazon (brand)", 
            "level": "High", 
            "name": "Amazon", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 4, 
            "useful": true
          }, 
          "55afc38792cffb786d83f91a": {
            "category": "default", 
            "display": "Food and drink", 
            "level": "Low", 
            "name": "Food and drink", 
            "parents": [], 
            "score": 1, 
            "useful": false
          }, 
          "55afc38792cffb786d83f924": {
            "category": "default", 
            "display": "Causes and activism", 
            "level": "High", 
            "name": "Causes and activism", 
            "parents": [], 
            "score": 46, 
            "useful": false
          }, 
          "55afc38792cffb786d83f92a": {
            "category": "brand", 
            "display": "Air Canada (brand)", 
            "level": "Medium", 
            "name": "Air Canada", 
            "parents": [
              "55afc38392cffb786d83f79d"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38892cffb786d83f94c": {
            "category": "default", 
            "display": "Personal finance", 
            "level": "Medium", 
            "name": "Personal finance", 
            "parents": [], 
            "score": 3, 
            "useful": true
          }, 
          "55afc38892cffb786d83f94e": {
            "category": "default", 
            "display": "Travel destinations", 
            "level": "High", 
            "name": "Travel destinations", 
            "parents": [], 
            "score": 4, 
            "useful": false
          }, 
          "55afc38892cffb786d83f95b": {
            "category": "default", 
            "display": "Pop music", 
            "level": "Low", 
            "name": "Pop music", 
            "parents": [
              "5457c85bd4ac147c8dd12710"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55afc38892cffb786d83f95f": {
            "category": "default", 
            "display": "JavaScript", 
            "level": "Medium", 
            "name": "JavaScript", 
            "parents": [
              "545ab86fd4ac144b79f8c30a"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38892cffb786d83f973": {
            "category": "default", 
            "display": "British politics", 
            "level": "Medium", 
            "name": "British politics", 
            "parents": [
              "5457c85bd4ac147c81e8b493"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55afc38892cffb786d83f97e": {
            "category": "default", 
            "display": "Popular culture", 
            "level": "High", 
            "name": "Popular culture", 
            "parents": [], 
            "score": 8, 
            "useful": false
          }, 
          "55b3c98492cffb11604e584a": {
            "category": "default", 
            "display": "Social media", 
            "level": "High", 
            "name": "Social media", 
            "parents": [], 
            "score": 4, 
            "useful": false
          }, 
          "55b40eef92cffb1a8fcbaba8": {
            "category": "brand", 
            "display": "American Airlines (brand)", 
            "level": "High", 
            "name": "American Airlines", 
            "parents": [
              "55afc38492cffb786d83f7e7"
            ], 
            "score": 6, 
            "useful": true
          }, 
          "55be4e3992cffb7c68a4b857": {
            "category": "default", 
            "display": "Social media analytics", 
            "level": "Medium", 
            "name": "Social media analytics", 
            "parents": [
              "55b3c98492cffb11604e584a"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55be4e6a92cffb7c68a4b859": {
            "category": "brand", 
            "display": "Hootsuite (brand)", 
            "level": "Medium", 
            "name": "Hootsuite", 
            "parents": [
              "55be4e3992cffb7c68a4b857"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55d4c29f92cffb4f7de7cc0f": {
            "category": "publisher", 
            "display": "Forbes (publisher)", 
            "level": "Low", 
            "name": "Forbes", 
            "parents": [
              "5457c85ad4ac147c59c0ca4f"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55da539c92cffb3a95d49c87": {
            "category": "community", 
            "display": "Product Hunt (community)", 
            "level": "Low", 
            "name": "Product Hunt", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55da543992cffb3a95d49c95": {
            "category": "publisher", 
            "display": "TechCrunch (publisher)", 
            "level": "Medium", 
            "name": "TechCrunch", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55db4d5092cffb7c6cf55664": {
            "category": "default", 
            "display": "Bootstrap framework", 
            "level": "Low", 
            "name": "Bootstrap framework", 
            "parents": [
              "545ab86fd4ac144b79f8c30a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55db691f92cffb21fa9d5b37": {
            "category": "nonprofit", 
            "display": "NASA (nonprofit)", 
            "level": "Low", 
            "name": "NASA", 
            "parents": [
              "5457c85bd4ac147c99d3f491"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55db6abe92cffb22e186777e": {
            "category": "brand", 
            "display": "SpaceX (brand)", 
            "level": "Low", 
            "name": "SpaceX", 
            "parents": [
              "5457c85bd4ac147c99d3f491"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55dccf2c92cffb0d3e808059": {
            "category": "community", 
            "display": "YouTube (community)", 
            "level": "Low", 
            "name": "YouTube", 
            "parents": [
              "55b3c98492cffb11604e584a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55e205d192cffb4aba02df92": {
            "category": "brand", 
            "display": "Union Square Ventures (brand)", 
            "level": "Low", 
            "name": "Union Square Ventures", 
            "parents": [
              "55afc38592cffb786d83f852"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55e206f392cffb7789ee2957": {
            "category": "brand", 
            "display": "Y Combinator (brand)", 
            "level": "Medium", 
            "name": "Y Combinator", 
            "parents": [
              "55afc38492cffb786d83f7fe"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55f31d6c92cffb5d161619cc": {
            "category": "celebrity", 
            "display": "Hillary Clinton (celebrity)", 
            "level": "Low", 
            "name": "Hillary Clinton", 
            "parents": [
              "55afc38492cffb786d83f7f0"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55f3493b92cffb4557864641": {
            "category": "celebrity", 
            "display": "Elon Musk (celebrity)", 
            "level": "Medium", 
            "name": "Elon Musk", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 3, 
            "useful": true
          }, 
          "55f355fc92cffb2eb7a8c083": {
            "category": "institution", 
            "display": "Massachusetts Institute of Technology (institution)", 
            "level": "Medium", 
            "name": "Massachusetts Institute of Technology", 
            "parents": [
              "55afc38492cffb786d83f7ed"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55f9fca692cffb2ddad75f73": {
            "category": "institution", 
            "display": "McGill University (institution)", 
            "level": "Medium", 
            "name": "McGill University", 
            "parents": [
              "55afc38492cffb786d83f7ed"
            ], 
            "score": 2, 
            "useful": true
          }, 
          "55fb1e5d92cffb6a1ab8b1fa": {
            "category": "artist", 
            "display": "diplo (artist)", 
            "level": "Low", 
            "name": "diplo", 
            "parents": [
              "55afc38592cffb786d83f86d"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55ff119092cffb402246af83": {
            "category": "celebrity", 
            "display": "Fred Wilson (celebrity)", 
            "level": "Low", 
            "name": "Fred Wilson", 
            "parents": [
              "55e205d192cffb4aba02df92"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55ff126c92cffb402246af8f": {
            "category": "celebrity", 
            "display": "Bill Gurley (celebrity)", 
            "level": "Low", 
            "name": "Bill Gurley", 
            "parents": [
              "55afc38592cffb786d83f852"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "55ff16a392cffb402246afa0": {
            "category": "celebrity", 
            "display": "Brad Feld (celebrity)", 
            "level": "Low", 
            "name": "Brad Feld", 
            "parents": [
              "55afc38592cffb786d83f852"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5601e86b92cffb6ff2c8cdfb": {
            "category": "artist", 
            "display": "Kygo (artist)", 
            "level": "Low", 
            "name": "Kygo", 
            "parents": [
              "55afc38592cffb786d83f86d"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5602cd3392cffb5b7ea6c74d": {
            "category": "celebrity", 
            "display": "Marissa Mayer (celebrity)", 
            "level": "Low", 
            "name": "Marissa Mayer", 
            "parents": [
              "5457c85bd4ac147cabc75c7a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5602d6b692cffb79fe5d074d": {
            "category": "celebrity", 
            "display": "Warren Buffett (celebrity)", 
            "level": "Low", 
            "name": "Warren Buffett", 
            "parents": [
              "5457c85bd4ac147c91c9655a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5603378292cffb602b940747": {
            "category": "nonprofit", 
            "display": "CERN (nonprofit)", 
            "level": "Low", 
            "name": "CERN", 
            "parents": [
              "5457c85bd4ac147c99d3f48f"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "560591f492cffb6b4bf16d68": {
            "category": "celebrity", 
            "display": "Paul Graham (celebrity)", 
            "level": "Low", 
            "name": "Paul Graham", 
            "parents": [
              "55e206f392cffb7789ee2957"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5617ecca92cffb7570539152": {
            "category": "celebrity", 
            "display": "Tim Cook (celebrity)", 
            "level": "Low", 
            "name": "Tim Cook", 
            "parents": [
              "546129ded4ac14770d4e9f1c"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "561d3d8292cffb4138675bcd": {
            "category": "universe", 
            "display": "James Bond (universe)", 
            "level": "Low", 
            "name": "James Bond", 
            "parents": [
              "55afc38592cffb786d83f876"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "561d682a92cffb4314e365b4": {
            "category": "celebrity", 
            "display": "Casey Neistat (celebrity)", 
            "level": "Low", 
            "name": "Casey Neistat", 
            "parents": [
              "55afc38392cffb786d83f79b"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "56355f0492cffb62175d4048": {
            "category": "brand", 
            "display": "British Airways (brand)", 
            "level": "Low", 
            "name": "British Airways", 
            "parents": [
              "55afc38492cffb786d83f7e7"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5637a02e92cffb1ad847f934": {
            "category": "place", 
            "display": "New York (place)", 
            "level": "High", 
            "name": "New York", 
            "parents": [
              "55afc38592cffb786d83f83e"
            ], 
            "score": 4, 
            "useful": true
          }, 
          "5640cfe292cffb4390263ca3": {
            "category": "celebrity", 
            "display": "Kaya Scodelario (celebrity)", 
            "level": "Low", 
            "name": "Kaya Scodelario", 
            "parents": [
              "55afc38692cffb786d83f88a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "5640fc5992cffb28279f1b22": {
            "category": "community", 
            "display": "Beme (community)", 
            "level": "Low", 
            "name": "Beme", 
            "parents": [
              "55b3c98492cffb11604e584a"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "568fea8e92cffb307b00f988": {
            "category": "brand", 
            "display": "Penguin Random House (brand)", 
            "level": "Low", 
            "name": "Penguin Random House", 
            "parents": [
              "5457c85ad4ac147c55ac2ddb"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "56a6c27d92cffb33834409b9": {
            "category": "brand", 
            "display": "Digital Ocean (brand)", 
            "level": "Low", 
            "name": "Digital Ocean", 
            "parents": [
              "5478bcabd4ac1436f0a6aba6"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "56e3579392cffb3549440a95": {
            "category": "artist", 
            "display": "Jess Glynne (artist)", 
            "level": "Low", 
            "name": "Jess Glynne", 
            "parents": [
              "55afc38892cffb786d83f95b"
            ], 
            "score": 1, 
            "useful": true
          }, 
          "56e3590c92cffb3549440a9d": {
            "category": "celebrity", 
            "display": "Neal Stephenson (celebrity)", 
            "level": "Low", 
            "name": "Neal Stephenson", 
            "parents": [
              "5457c85ad4ac147c55ac2ddb"
            ], 
            "score": 1, 
            "useful": true
          }
        }, 
        "confirmed": false, 
        "updated": 1461687238
      }, 
      "language": {
        "confirmed": false, 
        "primary": {
          "iso_code": "en", 
          "name": "English"
        }, 
        "recent": [
          {
            "iso_code": "en", 
            "name": "English", 
            "timestamp": 1458840726
          }
        ], 
        "updated": 1461687238
      }, 
      "location": {
        "confirmed": true, 
        "primary": {
          "city": "New York", 
          "country": {
            "code": "US", 
            "name": "United States"
          }, 
          "display": "New York, New York, United States", 
          "granularity": "city", 
          "latitude": 40.71427, 
          "longitude": -74.00597, 
          "subdivision": {
            "code": "NY", 
            "name": "New York"
          }
        }, 
        "updated": 1438044713
      }, 
      "platform": {
        "confirmed": false, 
        "primary": {
          "name": "Computer"
        }, 
        "recent": [
          {
            "name": "Computer", 
            "timestamp": 1458840726
          }, 
          {
            "name": "iOS", 
            "timestamp": 1437143415
          }, 
          {
            "name": "iPhone", 
            "timestamp": 1456513584
          }
        ], 
        "updated": 1461110464
      }, 
      "type": {
        "confirmed": true, 
        "personal": true, 
        "updated": 1436576887
      }, 
      "valid": true
    }
  }
}

Possible errors

Below are all the possible messages when the error field in the response is true.

Invalid API key

The API key is either invalid or missing from the request (it should be in the key GET parameter).

{
    "error": true,
    "message": "Valid API key required"
}

No users specified

No user IDs are specified (they should be in the ids GET parameter, separated by commas).

{
    "error": true,
    "message": "Nothing requested"
}

Period rate limits exceeded

The rate limits for the current period have been exceeded. See Authentication and rate-limiting for more information.

{
    "error": true,
    "message": "Rate limit exceeded"
}

Lifetime rate limits exceeded

The API key you are using does not have any remaining user queries.

{
    "error": true,
    "message": "Lifetime rate limit exceeded"
}

Sample code snippets

These code snippets are provided to illustrate very simple ways of accessing the Macromeasures API and are not meant to be used in production.

Python

import time

import requests

URL = 'https://api.macromeasures.com/twitter/users.json?key=KEY&ids='
def mm_get_users(*user_ids):
    url = URL + ','.join(user_ids)

    while True:
        response = requests.get(url)
        result = response.json()
        if result['complete']:
            return result

        time.sleep(1)

print mm_get_users('54904679', '15677079')

Ruby

require 'net/http'
require 'json'

def mm_get_users(*args)
    url = 'https://api.macromeasures.com/twitter/users.json?key=KEY&ids='
    url += args.join(',')
    url = URI.parse(url)
    req = Net::HTTP::Get.new(url.to_s)
    res = Net::HTTP.start(url.host, url.port) {|http| http.request(req)}
    result = JSON.parse(res.body)
    if result['complete']
        return result
    else
        sleep(1)
        return mm_get_users(args)
    end
end

puts mm_get_users('54904679', '15677079')