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

Hits per request:

Rate limit:

10 QPS

Required plan:

Large 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 .
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	Long	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

Authorized Digital Sellers for Pandora: Music & Podcasts on iOS by its ID:

https://data.42matters.com/api/v3.0/ios/apps/app_ads_txt.json?id=284035177&access_token=YOUR_ACCESS_TOKEN

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-09-27T00:55:55+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: 03 May 2023

Automate Your Workflow With 42matters’ APIs

Integrate app data and intelligence into your existing workflows, dashboards, CRM platforms, messaging platforms, and more! Below is a selection of the third-party services that are compatible with 42matters’ APIs: