App Audience API for Android Apps


The App Audience API gives you the big picture when it comes to the user base of a specific app. Our App Audience API sheds light on the gender distribution, the interests of the users and other apps the users are interested in.

Using Pinterest as an example, our API is able to tell you what proportion of Pinterest users are female or male, against the average number of female or male users. In the case of Pinterest, the ratio of females is far larger when compared to the average number of female users across all apps. Therefore we can conclude that it is likely that the Pinterest app is more popular with female users.


The API also returns the same stats about users’ interests. If we rank them by affinity (the ratio of Pinterest users having a certain interest divided by the ratio of all users having the same interest), we can find out the interests Pinterest users are most likely to have,



and the interests Pinterest users are most unlikely to have.



Moreover, the API returns the same stats about Pinterest users' apps, so you could get a list of apps that are popular among Pinterest users but not so much elsewhere.

Definition

Endpoint:

GET https://data.42matters.com/api/v2.0/android/apps/audience.json

Hits per request:

Varies with fields requested

  • 10 hits for gender affinity
  • 30 hits extra for interest affinity
  • 80 hits extra for app affinity
For example, a request with fields=gender_affinity,interest_affinity will cost 40 hits.

Rate limit:

2 QPS

Required plan:

professional or above.

Parameters

Name Required Description Available Values Default
access_token required Your access token for using this API. You can get it for FREE by signing up .
p required Specify an Android app to investigate by its package name. Package name of any Android app on Google Play
country optional Specify a list of countries by a comma-separated list of country codes. This would filters audience information only for specified countries. ID of Supported Countries
fields optional Comma-separated list of fields to return. The cost of request varies with fields requested. gender_affinity, interest_affinity, app_affinity All fields will be returned
callback optional If supplied, the response will use the JSONP format with a callback of the given name.

Responses

Status Code Indication Content-Type Body
200 Everything is OK application/json

Segment affinity object

Attribute Type Description
segment_id String ID of the segment among our segment taxonomy
segment_name_full String The full name of the segment including its ancestors' names
selected_audience_matched_ratio Double Selected audience refers to the users of specified app in specified countries. This matched ratio indicates how many times people in this segment appears in the selected audience.
reference_audience_matched_ratio Double Reference audience refers to the users of specified countries. This matched ratio indicates how many times people in this segment appears in the reference audience.
value Double Affinity value is the ratio between selected_audience_matched_ratio and reference_audience_matched_ratio. It indicates how many times more likely a user in selected audience would be in this particular segment than a user in the reference audience.

App affinity object

Attribute Type Description
package_name String Package name of an Android app
selected_audience_matched_ratio Double Selected audience refers to the users of specified app in specified countries. This matched ratio indicates how many times people having this particular appears in the selected audience.
reference_audience_matched_ratio Double Reference audience refers to the users in specified countries. This matched ratio indicates how many times people having this particular app appears in the reference audience.
value Double Affinity value is the ratio between selected_audience_matched_ratio and reference_audience_matched_ratio. It indicates how many times more likely a user in selected audience would have this particular app than a user in the reference audience.
202 The request is successful, and the result is being computed. application/json

Because the number of possible combinations of apps and countries is huge, the audience information is computed on request. This computation takes around 5 minutes. If you keep requesting the same app and country combinations, you'll continue to receive this 202 response until the result is there.

Once the specified app and country combinations are computed, the result will be returned immediately. It will also be cached and updated in the background, so all the following requests about the same app and country combination will get the result immediately.

To avoid our systems being abused, we'll still charge 1 hit for the request even though the computation is still undergoing.

Attribute Type Description
status String The status of the computation.
404 The package name is not found application/json Error object
402 Your request exceeds what's allowed by your current subscription plan application/json Error object
403 Your access token is not valid application/json Error object
429 Your request rate is over the limit application/json Error object

Example Request

Example Response

{
	"gender_affinity": [
		{
			"reference_audience_matched_ratio": 0.33768644608249,
			"selected_audience_matched_ratio": 0.56805140067752,
			"segment_id": "42m:25-1-2",
			"segment_name_full": "Demographics --> Gender --> Female",
			"value": 1.6821859665009
		},
		{
			"reference_audience_matched_ratio": 0.3172769026059,
			"selected_audience_matched_ratio": 0.1264486698709,
			"segment_id": "42m:25-1-1",
			"segment_name_full": "Demographics --> Gender --> Male",
			"value": 0.39854357134836
		}
	],
	"interest_affinity": [
		{
			"reference_audience_matched_ratio": 0.0042183884052612,
			"selected_audience_matched_ratio": 0.016648134220647,
			"segment_id": "42m:15-2",
			"segment_name_full": "Healthy living --> Yoga",
			"value": 3.9465626730539
		},
		{
			"reference_audience_matched_ratio": 0.0060529897223806,
			"selected_audience_matched_ratio": 0.022954127989085,
			"segment_id": "42m:15-3",
			"segment_name_full": "Healthy living --> Meditation",
			"value": 3.7921967559624
		},
		{
			"reference_audience_matched_ratio": 0.0058524391518208,
			"selected_audience_matched_ratio": 0.021202714755236,
			"segment_id": "42m:17-1",
			"segment_name_full": "Home & family --> Pregnancy",
			"value": 3.6228851262194
		},
		{
			"reference_audience_matched_ratio": 0.010577787022706,
			"selected_audience_matched_ratio": 0.037564124636417,
			"segment_id": "42m:5-2",
			"segment_name_full": "Entertainment --> Celebrities",
			"value": 3.5512271664937
		},
		{
			"reference_audience_matched_ratio": 0.007741017974802,
			"selected_audience_matched_ratio": 0.025633026501614,
			"segment_id": "42m:5-7-1",
			"segment_name_full": "Entertainment --> Music --> Concert",
			"value": 3.3113250201785
		}
	],
	"app_affinity": [
		{
			"selected_audience_matched_ratio": 0.067190580425854,
			"package_name": "com.etsy.android",
			"reference_audience_matched_ratio": 0.0072938872351878,
			"value": 9.2119028248349
		},
		{
			"selected_audience_matched_ratio": 0.038323329264393,
			"package_name": "com.target.socsav",
			"reference_audience_matched_ratio": 0.0048327665207616,
			"value": 7.9298946265573
		},
		{
			"selected_audience_matched_ratio": 0.016164003733242,
			"package_name": "com.kohls.mcommerce.opal",
			"reference_audience_matched_ratio": 0.0021667068206649,
			"value": 7.4601711588654
		},
		{
			"selected_audience_matched_ratio": 0.019600812407203,
			"package_name": "com.target.ui",
			"reference_audience_matched_ratio": 0.0027852783106045,
			"value": 7.0372904325488
		},
		{
			"selected_audience_matched_ratio": 0.018958109768174,
			"package_name": "com.ibotta.android",
			"reference_audience_matched_ratio": 0.0027600693038018,
			"value": 6.8687078770306
		}
	]
}

The lists of interest_affinity and app_affinity are shortened for demo purposes.


Last Modified: 2017-02-24


Get Free Support


We offer free email support to all our customers, with the 42matters team glad to provide you prompt, professional support. We’re here to help.


CONTACT US    KNOWLEDGE BASE