File Dumps for Connected TV apps


42matters provides enterprise data dumps of Connected TV Apps - Roku, tvOS and FireTV meta-data.

Dump Types


Daily, Weekly and Monthly file dumps contain metadata for all published and unpublished CTV apps. In order to distinguish the market status for each app, please refer to its respective market_status field.

Sample Data Dump

Data Format

Data is stored in a single gzipped file with line delimited JSON with the following characteristics:

  • Each line is a valid JSON object
  • UTF-8 encoding
  • Line separator is '\n'

Access Credentials

In order to obtain your Access Credentials, please read the File Dumps page or contact us.

App Schema Roku (v0.2)

Name Type Description
id Long App id - unique identifier.
channelId String Channel id - unique identifier. Either channel id or app id is present.
market_status String Status on the market
  • PUBLISHED if the app is present
  • UNPUBLISHED if the app was unpublished
Available in dumps starting from May 2020.
storeUrl URL A deep link to the app page on Roku Store
cc List of Objects List of app objects per country. Certain countries can support multiple app objects, e.g. CA -> en, fr
   lang String App language
   name String App title
   description String Full app description
   categories List List of app categories objects
   developer String App developer name
   developerId String App developer id
   hdPosterUrl URL App icon
   modifiedDate Date in ISO8601 extended format The last time the app was updated
   publishedDate Date in ISO8601 extended format The time the app was published
   createdDate Date in ISO8601 extended format The time the app was created
   rating Double App rating (from 0 to 100, 100 highest)
   starRatingCount Integer Total number of app ratings
   price String Formatted app price with currency
   isInAppPurchaseOffered Boolean A boolean flag that signifies whether the app offers in-app purchases or not.
   screenshotUrls List of URLs List of app screenshots
   keywords List of Strings List of keyword tokens
   parentalHint String Parental hint related to content. E.g. ContentNotRated
   deleted Boolean A boolean flag that signifies whether the app is deleted
   isPublic Boolean A boolean flag that signifies whether the app is public or not.
   taxClassification String App classification for tax purposes. E.g. "Video"
   internetRequired Boolean A boolean flag that signifies whether the app requires internet connection
   revenueSources List of Strings List of revenue sources, e.g. "Ads"
   isCvaaCompliant Boolean A boolean flag that signifies whether the app is CVAA compliant or not
   isSubscription Boolean A boolean flag that signifies whether the app is subscription based
   developerPrivacyUrl URL Developer privacy URL

App Schema tvOS (v0.1)

Name Type Description
trackId Integer Unique identifier for the app
bundleId String Bundle Identifier for the app, unique
market_status String Status on the market
  • PUBLISHED if the app is present
  • UNPUBLISHED if the app was unpublished
Available in dumps starting from May 2020.
cc Object Dictionary object that contains app metadata in different countries
   artistId Long The app artist ID
   artistName String The app artist name (human-readable string)
   artistViewUrl URL Link to the artist website
   artworkUrl100, artworkUrl512 URL Icon image with 100 and 512px square sizes
   averageUserRating Integer The average rating of the app for all versions
   userRatingCount Integer Number of ratings of the app for all versions
   formattedPrice String Price and currency of the app
   currency String The currency of the app price
   price Double App price, numeric value, 0 if free
   description String App description
   fileSizeBytes String App size in bytes, can be parsed as long
   fileSizeBytesNumeric Long App size in bytes
   genreIds List List of numeric genreIds of the app
   genres List List of genres of the app
   appletvScreenshotUrls List of URLs List of URLs to the AppleTV screenshots of the app
   trackCensoredName String App title
   trackViewUrl URL Link to the app on the Apple App Store
   primaryGenreId Integer Unique primary genre identifier
   primaryGenreName String Name of the primary genre of the app
   version String Current app version
   sellerName String Seller company name
   sellerUrl URL Link to the seller company website
   releaseDate Date in ISO8601 extended format Release Date of the app
   isGameCenterEnabled Boolean Does the app support Game Center from Apple
   contentAdvisoryRating String Advisory rating of the app content
   trackContentRating String Advisory rating of the app content
   languageCodesISO2A List of language codes Supported languages
   releaseNotes String The latest release notes
   supportedDevices List of Strings List of supported devices
   features List of Strings List of features, e.g. "iosUniversal" app
   minimumOsVersion String Minimum required OS version
   advisories List of Strings Advisories - e.g. "Infrequent/Mild Cartoon or Fantasy Violence"
   currentVersionReleaseDate Date in ISO8601 extended format The latest version release date
   isVppDeviceBasedLicensingEnabled Boolean Does the app support VPP distribution

App Schema FireTV (v0.1)

Name Type Description
asin String The app unique identifier (Amazon Standard Identification Number).
package_name String The app package name (internal unique identifier)
market_status String Status on the market
  • PUBLISHED if the app is present
  • UNPUBLISHED if the app was unpublished
Available in dumps starting from May 2020.
market_source String AMAZON - app is on the Amazon Appstore
title String App title
description String Full app description
category List List of app categories (human-readable)
developer String App developer name
what_is_new String 'What is new' message from the developer
icon URL Full-sized icon.
market_update Date in ISO8601 extended format The last time the app was updated
created Date in ISO8601 extended format The time the app was published
rating Double App rating (from 0 to 5, 5 highest)
number_ratings Integer Total number of app ratings
price_numeric Double The app price (numeric)
price String Formatted app price with currency
iap Boolean A boolean flag that signifies whether the app offers in-app purchases or not.
size Integer App size
size_min Integer Minimum app size (if app has multiple versions)
size_max Integer Maximum app size (if app has multiple versions)
screenshots List of URLs List of app screenshots
thumbs List of URLs List of app thumbnails
version String The current app version
minimum_operating_system String The minimum operating system required
age_rating String The age rating of the app.
permissions List of permissions List of human-readable permissions
features List of features supported by the app List of human-readable features
privacy_policy URL A link to the app privacy policy
website URL A link to the app website
market_url URL A deep link to the app page on Amazon Appstore

App Schema Samsung (v0.1)

Name Type Description
appId String The app unique identifier.
market_status String Status on the market
  • PUBLISHED if the app is present
  • UNPUBLISHED if the app was unpublished
appURL URL Link to the app page on the Samsung store.
categoryId String Category identifier.
categoryName String Category name (human-readable).
downloadCount Integer Number of downloads for the app on the Samsung store.
productDescription String App description (could include html tags).
productDescriptionPlain String App description in plain text.
productESRB String ESRB rating of the app.
productModifyDateTime Date in ISO8601 extended format The time the app was modified.
productRegisterDateTime Date in ISO8601 extended format The time the app was created.
productPrice Double App price.
productRated Integer Content-rating for the app, minimum age.
productRatedAbbr String Content-rating for the app.
productScreenShot1 URL Link to screenshot 1
productScreenShot2 URL Link to screenshot 2
productScreenShot3 URL Link to screenshot 3
productScreenShot4 URL Link to screenshot 4
productTitle String App title.
productVendor String App developer name.
reviewCnt Integer Number of reviews.
screenShot1080Img1 URL High-resolution screenshot 1.
screenShot1080Img2 URL High-resolution screenshot 2.
screenShot1080Img3 URL High-resolution screenshot 3.
screenShot1080Img4 URL High-resolution screenshot 4.
screenShot720Img1 URL Mid-resolution screenshot 1.
screenShot720Img2 URL Mid-resolution screenshot 2.
screenShot720Img3 URL Mid-resolution screenshot 3.
screenShot720Img4 URL Mid-resolution screenshot 4.
screenShot720LargeImg1 URL Large mid-resolution screenshot 1.
screenShot720LargeImg2 URL Large mid-resolution screenshot 2.
screenShot720LargeImg3 URL Large mid-resolution screenshot 3.
screenShot720LargeImg4 URL Large mid-resolution screenshot 4.
subCategoryId String Subcategory identifier.
subCategoryName String Subcategory name (human-readable).
tvOnly String Flag showing whether an app is for TVs.
webDisplay String Flag showing whether an app is for web displays.
widgetId Long Widget identifier.
widgetVersion String Widget version.
productThumbnailInURI URL App thumbnail.
productThumbnailOutURI URL App thumbnail.
productListInURI URL App icon.
productListOutURI URL App icon.

App Schema LG TV (v0.1)

Name Type Description
appId Long App id - unique identifier.
market_status String Status on the market
  • PUBLISHED if the app is present
  • UNPUBLISHED if the app was unpublished
cc List of Objects List of app objects per country. Certain countries can support multiple app objects with different languages, e.g. CA -> en, fr.
   appUrl URL Country-specific link to the app page on the LG store.
   appAge String Content-rating required age (human-readable).
   appName String App title.
   avgSscr Double Average app score (rating).
   age Integer Content-rating required age.
   appFileSize String App file size (human-readable).
   appSuptLangName String Supported languages (human-readable).
   appVer String App version.
   bigIconFile URL App big icon link.
   catCode String Category code.
   cat String Category (human-readable).
   detailExpln String App description.
   dplyDate Date in ISO8601 extended format Deploy date for the app.
   smallIconFile URL App small icon link.
   sellrUsrName String Seller name.
   sellrUserId String Seller id.
   sellrUsrNo Integer Seller user number.
   screenShotList List of URLs List of screenshots.
   requested_lang Language code The language for which metadata has been requested for the particular country.

Last Modified: 29 Apr 2020


Automate your workflow


Bring app data into your existing workflow, dashboards, CRM, messaging platforms and many more services! Here a selection of third-party services we support:



Email

Email

Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!


GET FREE INTEGRATIONS via Zapier!