Authenticate using OAuth 2.0 client credentials flow against the Reddit token endpoint to obtain a bearer token for the ads scope
Query the /api/v3/reporting/campaign endpoint with the account_id, campaign IDs, start_date, end_date, and a granularity parameter (TOTAL, DAY, or HOUR) to retrieve campaign-level metrics
Request conversion metrics by including event_type fields in the metrics parameter (e.g. view_conversion, click_conversion) alongside standard delivery metrics such as impressions, clicks, and spend
Paginate the response using the after cursor token returned in the pagination object when the result set exceeds the default page size
Join campaign-level report data with ad-level data from the /api/v3/reporting/ad endpoint to identify which individual promoted posts are driving the most conversions
Schedule regular pulls using a cron job, storing results incrementally with the report date as partition key; avoid re-pulling finalized data older than 7 days as it does not change
Known gotchas
Reddit Ads conversion data has a 24-48 hour attribution delay; pulling same-day or previous-day data will produce incomplete conversion counts that differ materially from finalized reports
The Reddit Ads reporting API enforces rate limits per access token; large accounts with many campaigns should paginate and add delays between calls to avoid HTTP 429 throttling
View-through and click-through conversion windows are configured per campaign objective; misunderstanding the attribution window when comparing Reddit conversions to other channels leads to over- or under-crediting Reddit's contribution
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