Pictory APIs are completely RESTful and all our responses are returned in JSON. This guide details API calls, return object properties and specific API flows.

All Pictory APIs are authorized using Access Token. The access token can be obtained by providing the Client ID and Client Secret in the Authentication API. Prior to working with the Pictory APIs, request client_id and client_secret from the Pictory sales team.

📝Try Pictory's API

You can try our API using Pictory's Postman collection.

Authentication

Access Token can be obtained by providing cliient_id and client secret in authorization API. Check More about Authentication Here.

📈API Request Headers

All API requests need to have Authorisation and X-Pictory-User-Id parameter in the header requests.

📈 API Responses

All API responses contain success and data properties in JSON format. Check the success property to verify the call's success.

Success Response

{  
    "success": true,  
    "data": {...}  
}

The data property of errors will include error_message and error_code to help you determine what went wrong. Non-zero error codes should never change. You can rely on them to make programming flow choices if necessary.

Error Response

{  
    "success": false,  
    "error": {  
        "error_message": "Error Message",  
        "error_code": 890  
    }  
}

Following are sample workflows which can be used to Create and Edit Videos:

:blue-heart: