---
search:
  tags:
    - Creatives
    - GET
seo:
  description: >-
    Available on: Meta. Reference for the GET
    /observe/{advertiserId}/creatives/{id}/previews endpoint in the AdCrunch
    API.
sidebar:
  label: Show a Meta creative in each placement
  badge: GET
title: Show a Meta creative in each placement
type: openapi-operation
---
**Available on:** [![Meta](/providers/meta.svg)](https://docs.adcrunch.dev/connect/providers)

Live read. Asks Meta now for the ad preview of one creative in each placement: the crop, what the overlays of a Story or a Reel cover, and what the image itself says, such as a price. Read it before you activate an ad.

Each placement gives one row. With `render` `image`, AdCrunch renders each placement and keeps the image for one day: `imageUrl` links to it. With `render` `link`, a row gives only `previewUrl`, the link of Meta, which stops working 24 hours after the read. A placement that Meta does not show for this creative is `unsupported`, and a placement that failed is `failed`. The other rows still come back. The status is `200`.

The creative must be in the ad account of the advertiser: an `id` of `GET /observe/{advertiserId}/creatives`. Another one answers `404`, with `error` of `not_found`, and AdCrunch reads no ad preview of it.

An advertiser that your organization does not own answers `404`, with `error` of `not_found`. An advertiser that does not exist, and one that is not a Meta ad account, answer the same.

AdCrunch keeps nothing from this read but the images. Each placement is one request to Meta, and counts against the rate limits of Meta.

`GET /observe/{advertiserId}/creatives/{id}/previews`

**Responses**

- `200` — One row for each placement.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`observe:read\`. \`error\` is \`forbidden\`.
- `404` — Your organization does not own the advertiser in the path, it does not exist, or it is not a Meta ad account. Then AdCrunch asks Meta nothing. The same status comes for an id that is not in the ad account of the advertiser. Then AdCrunch reads no ad preview. In each case, \`error\` is \`not\_found\`.
- `409` — This advertiser has no usable connection to Meta. A person must reconnect it.
- `502` — The provider refused the request, or could not answer it. This failure is often transient. Send the request again.

Response example, 200:

```json
{
  "data": [
    {
      "expiresAt": "2026-11-01T13:17:06.000Z",
      "height": 1248,
      "imageUrl": "https://ad-previews.adcrunch.dev/org_hxa7g1vfck6tamgdiwpvb7tq/0b6f2c1e-6a8d-4f0e-9b7a-3c2d1e0f9a8b.jpg",
      "placement": "instagram_reels",
      "previewUrl": "https://business.facebook.com/ads/api/preview_iframe.php?d=AQKERWN7Rq07pu&t=AQK9UMzb7sF",
      "reason": null,
      "status": "ok",
      "width": 640
    }
  ]
}
```
