Obtain API credentials from your IAS account manager; IAS provides an API key for authentication, included as an Authorization header or query parameter on all requests
Construct a report request by POSTing to the IAS reporting API endpoint, specifying the report type (brand safety, viewability, or invalid traffic), date range, and dimensions (campaign, placement, creative, publisher)
Poll the job status endpoint using the returned job ID until the report status is COMPLETED; IAS reports are generated asynchronously for large date ranges
Download the report from the URL provided in the completed job response, typically a CSV or JSON file with per-row metrics for each dimension combination
Parse the IAS Quality Score fields: viewability_rate, invalid_traffic_rate (IVT), brand_safety_violation_rate, and geographic compliance rate
Integrate the IAS metrics with your campaign spend data to calculate quality-adjusted CPM and flag placements exceeding your IVT or brand-safety thresholds for blocklisting
Known gotchas
IAS API access is typically gated by your contract tier; not all report dimensions or fraud metrics are available on all account levels, and requests for unavailable metrics may return empty data without a clear error
IAS finalizes viewability and IVT data on a 24-48 hour lag; pulling same-day data will return preliminary figures that can differ significantly from final, reconciled numbers
IAS brand-safety categories are configurable per campaign; the default category set may not match your advertiser's brand-safety requirements, so always confirm the category configuration is correct before using safety scores for optimization
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp