Preview a Meta ad creative

GET

/api/v1/meta/adcreatives/preview

Generates a preview for the requested Meta ad creative. This route currently accepts a body on a GET request because that is how the runtime is implemented.

Request

Query Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Meta ad creative preview payload.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.adlyfy.dev/api/v1/meta/adcreatives/preview?adAccountId=undefined' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data '{
    "adCreativeId": "120000000200",
    "adFormat": "DESKTOP_FEED_STANDARD",
    "productItemIds": [
        "SKU-001",
        "SKU-002"
    ]
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Request successful",
    "timestamp": "2026-03-30T12:00:00.000Z",
    "statusCode": 200,
    "data": {
        "data": [
            {
                "body": "<iframe src=\"https://www.facebook.com/ads/api/preview_iframe.php?d=AQL...&t=AQK...\" width=\"320\" height=\"568\" scrolling=\"yes\" style=\"border: none;\"></iframe>"
            }
        ]
    }
}

List Meta ad creatives

Get Meta ad creative details