Post Wizard
With the Dragla Post Wizard API, you can create visually striking and highly engaging image or video collage posts for your application or users. This documentation explains how to perform post creation tasks step-by-step using the Post Wizard.
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 |
|---|---|---|---|---|
| Title | String | Required | Specifies the title of your post. | Example: "How to Optimize Your Social Media Strategy" |
| 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 |
| PostType | String | Required | Determines the type of your post. | image, video-collage, video |
| PostSize | String | Required | Specifies the size of your post. | square, vertical, story |
| Keywords | String | Optional | Specifies the keywords for your post. | Example: "social media, digital marketing, advertisement" |
| Audience | String | Optional | Defines the target audience for your post. | Example: "Entrepreneurs" |
| 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) |
| Images | Array | Optional | The field needed to separately add images in your posts. If you want Dragla's AI to choose the images for your posts, leave this field empty! |
Takes "Index" and "URL" values. The "Index" value indicates which post it is for. Example: "Index: 1" means you will change the images in the first post. |
| VoiceOver | String | Optional | Voice-over settings for your videos. | `on`, `off` (Default: `on`) |
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 for images and 50 to 80 seconds for video and video collage posts. 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 images or video are queued, you will receive a "Queued" response; if the creation process is ongoing, you will receive a "Processing" response.
Once the images or video are created, you will receive a successful response as shown below.
If you selected "video" or "video-collage" as the post type, your video link will be in the "index: 1" field within the returned URL.
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. |
