List the account's own ads with per-ad metrics, sorted by the chosen KPI and capped at limit rows. The ad platform applies the sort + limit server-side, so this stays cheap regardless of total ad count.

Each item carries a thumbnail and the same metric bundle 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.

Timeout / page-size guidance: the underlying Marketing-API insights call scales linearly with the requested page size; high-volume ad accounts can exceed the upstream timeout at larger limits and return code=50001. The default is limit=10 and the validated range is 1–50, but limit > 20 is risky on busy accounts. The endpoint retries once with a halved limit on upstream failure, but if that still fails, prefer smaller page sizes (e.g. limit=5) and call the endpoint multiple times with different sort_by/sort_order combinations to enumerate the ads you need rather than asking for one large page.

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 (including after the internal shrink-retry exhausts).