# pinterest_list_ad_creatives

> List the ad account's ad creatives across every status (the API silently omits ARCHIVED ads unless asked) with their pin media resolved: public i.pinimg.com…

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Pinterest Ads](https://www.getmcpads.com/docs/sources/pinterest-ads)

List the ad account's ad creatives across every status (the API silently omits ARCHIVED ads unless asked) with their pin media resolved: public i.pinimg.com image URLs up to 1200px, video cover, and video_url when the app is allowed to read it. Catalog-driven formats are excluded by default.

|  |  |
| --- | --- |
| Source | [Pinterest Ads](https://www.getmcpads.com/docs/sources/pinterest-ads) |
| Kind | Read |
| Discovery | Announced in the tool list |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/pinterest-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `adAccountId` | string | Optional | Pinterest ad account ID. Defaults to the configured account. |
| `campaignIds` | array | Optional | Only ads in these campaigns. |
| `adGroupIds` | array | Optional | Only ads in these ad groups. |
| `includeArchived` | boolean | Optional | Include ARCHIVED ads (the API omits them by default) Default: `true`. |
| `excludeCatalogFormats` | boolean | Optional | Skip catalog-driven ads whose visuals come from the product feed. Default: `true`. |
| `maxAds` | integer | Optional | Ads scanned before media resolution. Default: `250`. |
| `maxPins` | integer | Optional | Unique pins resolved into media URLs. Each one costs an API call, and the Pinterest app quota is tight. Default: `40`. |

## Calling it

Directly, since it is announced

```json
{
  "name": "pinterest_list_ad_creatives",
  "arguments": {}
}
```

- [Pinterest Ads metrics](https://www.getmcpads.com/docs/sources/pinterest-ads/metrics): What you can ask for.
- [Pinterest Ads dimensions](https://www.getmcpads.com/docs/sources/pinterest-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/pinterest-ads/tools/pinterest_list_ad_creatives
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.