Skip to main content

Create Posts Using Own Images/Videos

In this example we will look at how to create posts using user's own images and videos instead of AI suggested images/videos. We will pass the media_urls parameter as a list containing the pubicly accessible URLs of images/videos.

If media_urls contain URLs of videos and media_type is set to either single_image or carousel, then URLs from media_urls will be ignored and AI suggested images will be used.

import requests

url = ""

payload = {
"brand_id": "YOUR_BRAND_ID",
"text": "3 tips for a healthy morning breakfast",
"media_type": "carousel",
"media_urls": ["..."]

headers = {"Authorization": "YOUR_API_KEY"}

response = requests.request("POST", url, data=payload, headers=headers)

if response.status_code == 200:
json_response = response.json()
post_id = response.get("post_id")
post_status = response.get("status")

print("Error occurred - {}".format(response.text))

If you get a inProgress status in response, your request is successful and the posts are getting generated. Once the posts get generated successfully (or fail), you will get a request on your configured webhook URL with more details about the posts. In the case of multiple posts, you will receive the webhook event for each post separately.