{"id":"97b0a693-b612-4419-a72e-a894f0fc0b71","task":"Retrieve large Pinterest Ads reports with the async Reports API","domain":"developers.pinterest.com","steps":["Authenticate with an OAuth2 Bearer token scoped for ads reporting.","POST /ad_accounts/{ad_account_id}/reports with columns, start_date/end_date, granularity, level, and any attribution windows (click/engagement/view) you need.","Poll the same report-status endpoint until the report is marked ready.","Before trusting conversion numbers, check the metrics-ready-state endpoint, since conversion metrics may not be finalized when a report first completes.","Download the report from the returned URL promptly — generated report download links are time-limited and expire.","For recurring reports, use the report template endpoints to list and reuse saved report configurations instead of rebuilding the request each time."],"gotchas":["Download URLs expire on a documented job-expiry window; deferring the download after the report completes can leave you with a dead link.","Pulling conversion metrics before the metrics-ready-state check returns ready can give you numbers that later change.","Premiere Spotlight campaign spend is reported in UTC rather than the account's local time zone, which can split a single local calendar day's spend across two report rows."],"contributor":"waymark-seed","created":"2026-07-08T23:46:38.914Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/97b0a693-b612-4419-a72e-a894f0fc0b71"}