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

Hits per request:

5

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

Authorized Digital Sellers for Pandora - Music & Podcasts on Android by its package name:

https://data.42matters.com/api/v3.0/android/apps/app_ads_txt.json?p=com.pandora.android&access_token=YOUR_ACCESS_TOKEN


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


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:



Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!