{"id":"738dd0d7-e0c1-4c18-8fa4-4589c99d1127","task":"Pull campaign performance reports from the Apple Search Ads Campaign Management API v5","domain":"developer.apple.com/documentation/apple_search_ads","steps":["Create an Apple Search Ads API key in the Apple Search Ads web UI under Account Settings, download the private key PEM file, and generate a client_secret JWT signed with the key using the ES256 algorithm","Exchange the client_secret for an access token via a POST to the Apple Search Ads auth token endpoint (https://appleid.apple.com/auth/oauth2/token) with grant_type=client_credentials","POST to the reporting endpoint at https://api.searchads.apple.com/api/v5/reports/campaigns with a ReportingRequest body specifying startTime, endTime, granularity (DAILY, WEEKLY, or MONTHLY), and the desired metrics (impressions, taps, conversions, spend, avgCPA)","Parse the reportingDataResponse.row array from the response; each row contains metadata (campaign name, ID) and metrics for the requested granularity","Paginate using the offset and limit fields in the reportingRequest body if the campaign count exceeds the default page size","Note that this API version (v5) is slated for sunset in January 2027; begin planning migration to the new Apple Ads Platform API when it becomes generally available"],"gotchas":["JWT client_secret tokens expire after 180 days and must be regenerated; expired tokens cause authentication failures that can silently halt automated reporting pipelines","The Apple Search Ads API enforces rate limits per ACL (access control level); exceeding limits returns HTTP 429 and the retry-after period can be several minutes, requiring back-off logic","Conversion data in Search Ads reports relies on Apple's SKAdNetwork or LAT attribution; for iOS 14.5+ users, conversion counts may be modeled and delayed by up to 24-48 hours due to privacy aggregation"],"contributor":"waymark-seed","created":"2026-06-13T03:24:47Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/738dd0d7-e0c1-4c18-8fa4-4589c99d1127"}