App Store Ads Scraper: Apple Search Ads Library
Pricing
from $1.25 / 1,000 ads
See which apps buy App Store ads against yours: every Apple Search Ads ad shown in the EU in the last year, by app, developer, link, file or country, with slot, days running, creative and targeting flags. Add-ons: advertiser lists with ad counts, Apple's restrictions feed, changed ad alerts.
Row type
type
Optional
ad for one ad; coverage for one row per app, developer or browsed country (Apple's total, pages read, why the walk stopped, complete or not); status for a free row (a name with no or several matches, a target without ads, a call Apple did not answer, skipped inputs); summary for the last row with the run counters and billing.
Ad id
adId
Optional
Apple's id of the ad (32 hex characters). One ad id is one ad in one country.
Country
country
Optional
The country the ad was shown in (ISO code); countryName holds Apple's name for it.
App
appName
Optional
The advertised app's name as shown in that country.
App id
appId
Optional
The App Store id of the app (text, so long ids keep every digit).
App Store link
appStoreUrl
Optional
The app's App Store page in the ad's country.
Developer
developerName
Optional
The developer as the App Store names it, the entity on whose behalf the ad ran.
Developer id
developerId
Optional
The App Store id of the developer (text).
Legal name
legalName
Optional
The legal name of the seller on the App Store; differs from the developer name on about 30 percent of ads.
Placement
placement
Optional
Where the ad ran, as Apple writes it: APPSTORE_SEARCH_RESULTS, APPSTORE_SEARCH_TAB, APPSTORE_TODAY_TAB or APPSTORE_PRODUCT_PAGE; placementName holds the plain name.
Format
format
Optional
Icon Ad or Icon + Asset Ad (with screenshots or a video).
First shown
firstShown
Optional
First day Apple recorded an impression (YYYY-MM-DD); it can lie before the period asked for.
Last shown
lastShown
Optional
Last day Apple recorded an impression (YYYY-MM-DD).
Days shown
daysShown
Optional
Days from the first to the last day shown, both counted.
Targeting used
targetingUsed
Optional
True when the campaign used at least one of Apple's audience refinements (age, gender, location, customer type); targeting holds the four flags. Apple publishes whether each was used, not its values.
Subtitle
subtitle
Optional
The app's subtitle on the App Store.
Category
category
Optional
The app's primary App Store category.
Description
description
Optional
The App Store description Apple shows with the ad (its shortDescription, on every ad); promotionalText holds the promotional text when the ad has one (about 30 percent of ads).
Screenshots and videos
assets
Optional
The ad's creative assets in their order: type (image or video), URL, width, height, orientation.
Variations
variations
Optional
Only with Add variations: status (ok, failed, not_found, not_read), iconUrls and one entry per language version (language, app name, subtitle, category, promotional text, devices with their assets).
Found by
foundBy
Optional
The app, developer, name or country that found the ad, and the countries asked.
Period start
periodStart
Optional
First day of Apple's reporting window the ad was read in.
Period end
periodEnd
Optional
Apple's latest day for that window (about 5 to 7 days before the run).
Apple's total (coverage rows)
appleTotal
Optional
On a coverage row: the number of ads Apple reported for the app, developer or country in the countries and period asked.
Complete (coverage rows)
complete
Optional
On a coverage row: true when every page was read and the distinct ads seen equal Apple's total.
Change status
changeStatus
Optional
With Deliver changed ads again: new for an ad the memory did not know, updated for a known ad Apple now reports with a later last day shown (charged as an Ad update).
Previous last shown
previousLastShown
Optional
On an updated ad: the last day shown when the memory delivered it before.
Advertiser id
advertiserId
Optional
On an advertiser row: the App Store id of the app or developer (advertiserType says which).
Ads count
adsCount
Optional
On an advertiser row: Apple's total of its ads in the countries and period asked (0: a free row).
Latest shown
latestShown
Optional
On an advertiser row: the newest last day shown among its ads (from its newest ads).
Restriction action
action
Optional
On a restriction row: ACTION_ADVERTISING_REMOVED or ACTION_ACCOUNT_SUSPENDED (actionName holds the plain name), with actionDate, reason, basis, details, placements and countries.
Restriction reason
reason
Optional
On a restriction row: Apple's reason code, for example REASON_TOS_INCOMPATABILITY (as Apple writes it).
