App-Ads.txt API for Android Apps
Get the Authorized Digital Sellers for Android apps. This specification from IAB is designed to protect mobile app ad inventory by allowing apps to list authorized sellers of their app’s ad inventory on their developer website.
Definition
Endpoint:
GET
https://data.42matters.com/api/v3.0/android/apps/app_ads_txt.json
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 |
The package name identifying an Android application. |
Any publicly available Android app package name |
|
include_unpublished |
optional |
Flag whether to return unpublished apps |
true, false |
false |
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 |
Attribute |
Type |
Description |
package_name |
String |
The app package name (unique identifier) |
market_status |
String |
Status on the market
- PUBLISHED if the app is present
- UNPUBLISHED if the app was unpublished
|
title |
String |
App title |
developer |
String |
App developer name |
website |
URL |
App website |
market_url |
URL |
A deep link to the app page on Google Play |
content_rating |
String |
Advisory rating of the app content |
category |
String |
The app category (human-readable string) |
cat_key |
String |
The app primary category key. Refer to the Google Play categories for more information. |
cat_keys |
List of Strings |
All app category keys. E.g. family-friendly apps have multiple category keys. Refer to the Google Play categories for more information. |
app_ads_txt |
Object |
The fields of this object are described below |
app_ads_txt.domain |
String |
The domain used to crawl the app-ads.txt file |
app_ads_txt.url |
String |
The complete URL used to crawl the app-ads.txt file |
app_ads_txt.raw |
String |
The raw content of the app-ads.txt file (if existing) |
app_ads_txt.content_type |
String |
The content type of the "app_ads_txt.raw" field |
app_ads_txt.supported |
Boolean |
True if this app supports the app-ads.txt standard by IAB |
app_ads_txt.inventorypartnerdomain |
List |
List of Inventory Partner Domains |
app_ads_txt.crawled_timestamp |
String |
The date when the app-ads.txt was crawled, format "YYYY-MM-DD" |
app_ads_txt.authorized_digital_sellers |
Array of Objects |
List of Authorized Digital Sellers as specified in the app-ads.txt file for this app. Each object contains: ad_domain_name (Domain name of the
advertising system), ca_id (Certification Authority), rel (Relationship), pub_acc_id (Publisher’s Account ID).
|
app_ads_txt.authorized_digital_sellers_from_partner_domain |
Array of Objects |
List of Authorized Digital Sellers found on inventory partner domains (inventorypartnerdomain line) for this app. Each object contains: ad_domain_name (Domain name of the
advertising system), ca_id (Certification Authority), rel (Relationship), pub_acc_id (Publisher’s Account ID), inventorypartnerdomain (Partner domain).
|
|
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
This request can also be imported into Postman.
Check out our Postman integration guide.
Example Response
{
"package_name": "com.pandora.android",
"title": "Pandora - Music & Podcasts",
"market_url": "https://play.google.com/store/apps/details?id=com.pandora.android&referrer=utm_source%3D42matters.com%26utm_medium%3Dapi",
"content_rating": "Teen",
"category": "Music & Audio",
"cat_key": "MUSIC_AND_AUDIO",
"cat_keys": [
"MUSIC_AND_AUDIO",
"APPLICATION"
],
"developer": "Pandora",
"website": "http://www.pandora.com",
"market_status": "PUBLISHED",
"app_ads_txt": {
"supported": true,
"crawled_timestamp": "2023-03-25T04:55:02+00:00",
"authorized_digital_sellers": [
{
"ad_domain_name": "google.com",
"rel": "DIRECT",
"pub_acc_id": "pub-7193423889248675",
"ca_id": "f08c47fec0942fa0"
},
{
"ad_domain_name": "adswizz.com",
"rel": "DIRECT",
"pub_acc_id": "Pandora",
"ca_id": null
},
{
"ad_domain_name": "indexexchange.com",
"rel": "DIRECT",
"pub_acc_id": "188031",
"ca_id": "50b1c356f2c5c8fc"
},
{
"ad_domain_name": "adswizz.com",
"rel": "DIRECT",
"pub_acc_id": "pandora",
"ca_id": null
},
{
"ad_domain_name": "facebook.com",
"rel": "DIRECT",
"pub_acc_id": "10152265089896344",
"ca_id": "c3e20eee3f780d68"
},
{
"ad_domain_name": "aps.amazon.com",
"rel": "DIRECT",
"pub_acc_id": "ed1f651d-c9ea-451e-9879-1b8e00542b36",
"ca_id": null
}
],
"unique_sellers": [
],
"url": "https://pandora.com/app-ads.txt",
"domain": "pandora.com",
"authorized_digital_sellers_from_partner_domain": [
],
"inventorypartnerdomain": null,
"raw": "OWNERDOMAIN=pandora.com\n\ngoogle.com,pub-7193423889248675,DIRECT,f08c47fec0942fa0\nadswizz.com,Pandora,DIRECT\nindexexchange.com,188031,DIRECT,50b1c356f2c5c8fc\nadswizz.com,pandora,DIRECT\nfacebook.com,10152265089896344,DIRECT,c3e20eee3f780d68\naps.amazon.com, ed1f651d-c9ea-451e-9879-1b8e00542b36, DIRECT",
"content_type": "text/plain"
}
}
Last Modified: 22 Feb 2022