By plotly
Updated a year ago

Plotly API Documentation

Scientific graphing and plotting libraries for making interactive, web-ready, publication-quality graphs.

Your data and graphs are always together. This means you can code, analyze, store, share, and collaborate in Plotly. Available for Python, R, MATLAB, Arduino, REST, Julia, and Perl.

Learn more about this API
POSTGraph Response
POSTGraph Response

Make graphs in your browser! Send data to your Plotly account and receive a url where you can visit and share you graph! See for more details.

Header Parameters
Required Parameters
REQUIREDAPI key. Generated from a apimkacct POST or available in a user's settings pane.
REQUIREDPlotly username
REQUIREDLanguage or platform that the client is making the request from.
REQUIREDVersion of the API client code. This parameter may be used to issue a warning response to users that are using an out-of-date client library.
REQUIREDOptions as a key-value JSON object. key value filename required Name of the plot in your plotly account. Use / to specify directories. If a directory path does not exist it will be created. Example Values {"filename": "plot from api"}, {"filename": "data/temperature vs humidity"} fileopt required "new", "overwrite", "append", or "extend" See below for an illustrative example of these values. style optional The trace-style object as described above and in the examples. The style object is applied to every single trace (default) or to the traces specified in the optional traces key-value pair. Example Values Apply style to all traces, e.g. make every trace a bar type: {"style":{"type": "bar"}} Apply style to select traces by index, e.g. make traces 0, 1, and 5 a bar type plot: {"style": {"type": "bar"},"traces": [0,1,5]} Apply style to select traces by name, e.g. make the traces titled "experimental" and "control" a bar type: {"style": [{"name": "experiment", "type": "bar"},{"name": "control", "type": "bar"}]} traces optionally used with style traces specifies the indices that the style object should be applied to. layout a key-value paired object that describes the layout of the plot. See below for an example that specifies all available key-value pairs. Example Values {"title": "my plot title", "xaxis": {"name": "Time (ms)"}, "yaxis": {"name": "Voltage (mV)"}} world_readable optional (default: true) If true: graph is viewable by anyone who has the link and in the owner's plotly account. If false: graph is only viewable in the owner's plotly account.
REQUIRED"plot", "style", or "layout".
REQUIREDData and/or styling argument. The structure of args depends on the value of origin. If origin=plot: Either args=[x1, y1[, ..., xn, yn]] where xi, yi are arrays of numbers or strings or args=[data1[, ... datan]] where datai is a JSON object with at least the names x, y, or z but may contain more styling and chart-type data. See the examples below for many examples. If origin=style: args=[style1[,style2, ...]] where stylei is a JSON object that customizes the style of the i'th trace. It is identical to the datai object used in origin=plot except that it doesn't contain the data key-value pairs x, y, or z. If origin=layout: args=layout where layout is an object that customizes the style of the layout, the axes, and the legend.
Code Snippet
Install SDK

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication