The account's own ads with their metrics, ranked by sort_by and capped at limit rows. Ranking covers every ad in the window, so the top rows are the account's best on that metric — not just the best of an arbitrary page.

Each item carries a thumbnail and the same metric set as /summary. Use the returned platform_ad_id with GET /open/v1/ad-accounts/{account_id}/ads/{platform_ad_id} to drill into a single ad's creative + text copy.

Metrics: metrics is keyed by metric id, with metric_names giving each id's display name. Ids come from GET /open/v1/ad-accounts/{account_id}/metrics; pass them in metrics to add custom conversions, custom events and Atria custom metrics on top of the default set. null means no data for that metric in the window. Figures can differ slightly from the ad platform's own reporting.

Returns: code=0 success; code=40001 invalid query / path parameters or workspace context missing; code=40401 when the account does not exist or belongs to a different workspace; code=50001 when the upstream platform API is unavailable.