App-Ads.txt API for iOS Apps
Get the Authorized Digital Sellers for iOS 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/ios/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
.
|
|
|
id |
required |
The app ID on the Apple App Store - (e.g for Facebook the ID is 284882215).
|
Existing App ID on Apple App Store |
|
bundleId |
optional |
The app bundleId on the Apple App Store (e.g for Angry Birds the bundleId is com.clickgamer.AngryBirds). Note: this parameter is required if no id parameter is specified.
|
Existing App bundleId on Apple App Store |
|
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 |
trackId |
String |
Numeric unique identifier for the app assigned by Apple |
bundleId |
String |
Unique identifier for the app assigned by the developer. |
market_status |
String |
Status on the market
- PUBLISHED if the app is present
- UNPUBLISHED if the app was unpublished
|
trackCensoredName |
String |
App title |
sellerName |
String |
Seller company name |
sellerUrl |
URL |
Link to the seller company website |
trackViewUrl |
URL |
Link to the app on the Apple App Store |
trackContentRating |
String |
Advisory rating of the app content |
primaryGenreName |
String |
Name of the primary genre of the app |
primaryGenreId |
Integer |
Unique primary genre identifier. See App Store Genres for more information. |
genreIds |
List |
List of numeric genreIds of the app. Refer to the App Store Genres 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 track id/bundle id 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
{
"trackId": 284035177,
"bundleId": "com.pandora",
"trackViewUrl": "https://apps.apple.com/us/app/pandora-music-podcasts/id284035177?uo=4",
"trackCensoredName": "Pandora: Music & Podcasts",
"trackContentRating": "12+",
"primaryGenreName": "Music",
"primaryGenreId": 6011,
"genreIds": [
"6011"
],
"sellerName": "Pandora Media, LLC",
"sellerUrl": "http://www.pandora.com/",
"market_status": "PUBLISHED",
"app_ads_txt": {
"supported": true,
"crawled_timestamp": "2023-03-25T08:58:29+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