API Quickstart - Picsart API

Quickstart

Everything you need to get running within a few minutes with Picsart APIs.

Review Our Documentation

Browse to find the API you want to use, and click to Open.
Each API specification contains:

An overview of the service
Modifiable parameters
Possible error codes and responses
Dynamic documentation including ability to test with Demo and Production servers
Code samples in different languages.

Log In

To log in to the portal:

Click Log In at the top of the header.
Note: New user? Click Create an Account and follow prompts to register (no credit card required).
Enter your account info and click Sign In.

Create an App & Get an API Key

An app is required to demo the API services. Follow these steps to create an app:

Select Apps from the user drop-down menu.
Click + New App to create a new app.
Enter a name and description for the app in the New App dialog.
Click Enable on Picsart Image API Demo product.
Click Save.
Copy the API Key for your app.

Try Picsart Image APIs

After creating an app, follow these steps to authenticate your app and to try out each API service:

Select Documentation then select API Reference from the drop-down menu.
Click Authorize to input your unique API key.
Enter your unique API key in the ‘apiKey’ Value field. NOTE: You can find your API key on the Apps page.
Click Authorize and Close.
Select the specific API endpoint you want to test.
Click Try it out.
Complete required fields in the ‘Request body’.
Click on Execute.
Check the result’s URL
Use provided code samples in different languages to get exactly the same result in your app.

Go Live

Once your App is set up, integration to your platform is a snap!

Picsart Image Tools API is a simple RESTful service that can be easily integrated using different frameworks. The Open API spec can also be downloaded from the API Reference and a code generator can be used to get the code in your preferred programming language.
To gain access to the Production environment, you will need to contact the Picsart Developer Success team at apibusiness@picsart.com.
Once a Production request has been reviewed and approved, which may include formal contract and/or SOW then access will be granted.

API Errors

We strive for perfection, but errors happen. Here is a list of potential error codes.

Error Code	Message	Description
200	Success	Congratulations, your call was successful.
400	Bad request	The server could not understand the request due to invalid syntax or input parameters that did not meet the requirements.
401	Unauthorized	Although the HTTP standard specifies “unauthorized”, semantically this response means “unauthenticated”. That is, the client must authenticate itself to get the requested response. Check if the APIKEY is provided in either the request header or in the query string.
403	Forbidden	The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401, the client’s identity is known to the server.
404	Not Found	Not found. Verify that the request URL is spelled correctly and that the API you are trying to access exists. For example, ensure that you are not trying to access the wrong revision of an API.
405	Method Not Allowed	Method not allowed. You specified a method that is not supported. For example, you used the GET verb for an API call that requires the POST verb.
413	Request Entity Too Large	Request Entity Too Large
415	Unsupported Media Type	The media format of the requested data is not supported by the server, so the server is rejecting the request. Typically, this error occurs on POST or PUT requests when the Content-type HTTP header is set to the wrong value. For example, an HTTP 415 error is returned if you POST the following to an API that only supports JSON: $ curl https://api.picsart.io/tools/demo/upscale -X POST -H “Content-type:text/xml” -d ‘’ For GET requests, use the Accept header instead of the Content-type header.
429	Too Many Request	The rate limit was exceeded on Quota.
431	Request Header Fields Too Large	Request Header Fields Too Large
500	Internal Server Error	The server encountered an unexpected condition that prevented it from fulfilling the request. If the error persists, please, check the service status at status.picsart.io.
503	Service Unavailable	The service is temporarily unavailable. Please, check the current status at status.picsart.io.

For high error rates you can check the service status at status.picsart.io. There you can subscribe for updates, including upcoming maintenance. In case you don’t see the problem escalated on the Status page, please contact us with a Request type of ‘Troubleshooting’ or send a direct email to apitechsupport@picsart.com. We will make sure to follow up as soon as possible.

Maintenance

Subscribe to updates on status.picsart.io.
Set up Error Code monitors in your environment and report them when you see an increase in problems.
Use contact form, direct email to devsupport@picsart.io, or other communication channels to reach out directly.
Continuous improvement is what we seek and it’s our ultimate goal to make sure your and your end user experience is brought to perfection. We would love to hear from you about how the implementation process went and how the services run on your production.