Product Photo Ad Creatives
With Dragla’s Product Photo Ad Creatives API, you can create professional posts by generating the most suitable and striking environments to showcase the products in your application or for your users. This documentation explains how to perform post creation tasks step-by-step using the Product Photo Ad Creatives feature.
Getting Started
To use the API, you will need an API key. Visit (https://app.dragla.co/api) to obtain this key by registering on the platform. Once you have your API key, you can use it to authenticate your API requests.
Authorization: X-Api-Key: YOUR_API_KEY
Parameters
| Property | Data Type | Required | Description | Parameters |
|---|---|---|---|---|
| ProductName | String | Required | The name of the product. | Example: "Elegant Watch" |
| ProductDescription | String | Required | A description of the product. | Example: "A sleek and modern watch with a durable leather strap and water-resistant features." |
| ProductImageUrl | String | Required | URL of the product image. | Example: "https://example.com/product-image.jpg" |
| BackgroundMode | String | Required | Selection of the background. | Surprise me, Studio, Silk, Cafe, Tabletop, Light Wood, Dark Wood, Marble, Park Bench, Outdoors, Flowers, Roses, Lavender, Monstera, Meadow, Dried Flowers, Kitchen, Fruits, Nature, Beach, Bathroom, Skyscraper, Gifts, Christmas, Wedding, Halloween, Easter, Paint, Fire, Water, Gold, Pebbles, Snow |
| LogoUrl | String | Required | Used for the logo area in your post. | Example : "https://www.storagesite.com/logo.png" |
| Website | String | Required | Used for the website area in your post. | Example: "www.yoursite.com" or "@username" |
| Language | String | Required | Specifies the language of your post. | English, Turkish, Espanol, French, German, Italian, Japanese, Korean |
| PostSize | String | Required | Specifies the size of your post. | square, vertical, story |
| Keywords | String | Optional | Specifies the keywords for your post. | Example: "celebration", "holiday", "national day" |
| Audience | String | Optional | Defines the target audience for your post. | Example: "Citizens" |
| Tone | String | Optional | Specifies the tone of your post. | excited, professional, encouraging, dramatic, engaging, creative |
| ColorPalette | Object | Optional | Changes the color settings of your posts. If you want Dragla's AI to choose the colors for your posts, leave this field empty! |
ColorOne, ColorTwo, ColorThree, ColorFour fields are all mandatory and should be in Hex Code! (e.g., #ad8b73) |
Request [POST]
Note: The example below provides a complete request structure; you are not required to send fields outside the mandatory ones.
Successful Response
The turnaround time will be approximately 30 to 45 seconds. Please consider these processing times.
To retrieve the results, you need to make a "GET" request with the `creationId` as shown below.
Results [GET]
If the creation process is ongoing, you will receive a "Processing" response.
If the images have been created, you will receive a successful response as shown below.
Error Codes
| Code | Name | Description |
|---|---|---|
| 400 | Bad Request | Invalid Request Format: Check your request parameters. |
| 401 | Unauthorized | Unauthorized User: Verify your API key. |
| 404 | Not Found | No valid results found for the specified address. |
| 406 | Not Acceptable | Check your API key. |
| 500 | Server Error | Request could not be completed due to a server issue. |
