Plots Instance
Plots
This endpoint handles manipulation of Plotly plot files.
Reference
Authorization
Any user with or without a Plotly account may view public plots. For private plots, see authentication.
Actions
list
Listing all public plots can be done via a GET request to this endpoint.
By default, plots will be listed in order of date created. The order_by
query parameter is accepted at this endpoint. Currently, only ordering by
views is supported. It is possible to filter the plots by quality
with min_quality or max_quality as query parameter.
Example:
// GET https://api.plotly.com/v2/plots/ ---> 200
// GET https://api.plotly.com/v2/plots/?order_by=-views ---> 200
// GET https://api.plotly.com/v2/plots/?min_quality=5 ---> 200
// GET https://api.plotly.com/v2/plots/?max_quality=5 ---> 200
feed
Listing all handpicked feed plots can be done via a GET request to this endpoint. By default, plots will be listed in a random order.
Example:
// GET https://api.plotly.com/v2/plots/feed ---> 200
create
You can create new plot resources here. The only required field is 'figure'. Currently, the figure is restricted to only contain references to grid data. That is, this will fail if raw data arrays are passed in. To create and manipulate underlying grids for plots, see the grids endpoint.
Example:
// This fails because a figure field is required.
// POST https://api.plotly.com/v2/plots ---> 400 Bad Request
{}
// This fails because the figure has raw data
//POST https://api.plotly.com/v2/plots ---> 400 Bad Request
{
"figure": {"data": [{"y": ['this', 'is', 'raw', 'data']}]}
}
// This succeeds because the figure has src keys, not raw data.
//POST https://api.plotly.com/v2/plots ---> 200 OK
{
"figure": {"data": [{"ysrc": "sven:88:u8nd62"}]}
}
When creating a grid, you can optionally specify a source_fid to specify where a plot has come from:
- source_fid: the fid of a plot that was copied (and presumably edited) to produce this one
detail
There is a lot of meta information stored about plot files including filename, title, share_url, and content_url to name a few.
This information can only be reached with a GET to this endpoint.
Example:
// GET https://api.plotly.com/v2/plots/iheartgraphs:90
content
The contents of a plot can be downloaded via the content resource. The plot
content contains referenced grid/column data by default. If you wish to
return the raw grid/column data, the inline_data=true query must be included
in the request url. The Content-Type header will be appropriately set for the
response body.
Alternatively, you can set ?map_data=unreadable to append a mapping of
sources to data that belongs to grids which are unreadable for the
requestor. This is useful when you have read access to another users plot,
but that plot contains grid references which you don't have access to.
Examples:
// Returns referenced grid/column data
// GET https://api.plotly.com/v2/plots/iheartgraphs:90/content ---> 200 OK
// Returns full grid/column data
// GET https://api.plotly.com/v2/plots/iheartgraphs:90/content?inline_data=true ---> 200 OK
// Returns full grid/column data when requestor doesn't have permission
// to read the referenced grid.
// GET https://api.plotly.com/v2/plots/iheartgraphs:90/content?map_data=unreadable ---> 200 OK
GET /v2/plots/markplotly1:7/?format=api
{ "creation_time": "2015-11-21T18:22:48.038969Z", "comments": { "results": [], "count": 0 }, "parented": true, "embed_url": "https://chart-studio.plotly.com/~markplotly1/7.embed", "fid": "markplotly1:7", "filename": "wireframe_plot", "filetype": "plot", "img_url": "https://storage.googleapis.com/plotly-prod-images/markplotly1/7/9_55P8H65B6LQCUI9Z26EB491BOBVVWC.png", "image_urls": { "default": "https://storage.googleapis.com/plotly-prod-images/markplotly1%2F7%2F2_3RB67ECVGK3Z2RWKE978IAYPIUKZI0.png", "block-thumb": "https://storage.googleapis.com/plotly-prod-images/markplotly1%2F7%2F8_5WW640RXUZWUGI9F1LCQN6NOKUKVVU.png", "list-thumb": "https://storage.googleapis.com/plotly-prod-images/markplotly1/7/9_55P8H65B6LQCUI9Z26EB491BOBVVWC.png" }, "api_urls": { "files": "https://api.plotly.com/v2/files/markplotly1:7", "plots": "https://api.plotly.com/v2/plots/markplotly1:7", "parent": "https://api.plotly.com/v2/folders/home?user=markplotly1" }, "owner": "markplotly1", "parent": -1, "preview": "", "referencers": [], "references": [], "title": "Wireframe Plot", "views": 4, "web_url": "https://chart-studio.plotly.com/~markplotly1/7/wireframe-plot/", "world_readable": true, "date_modified": "2015-11-21T18:22:48.513Z", "stars": { "results": [], "count": 0 }, "collaborators": { "results": [], "count": 0 }, "subfolder_count": null, "refresh_interval": null, "organize_view_url": "https://chart-studio.plotly.com/~markplotly1/7/", "current_user_permission": "read", "is_theme": null, "is_template": null, "autosize": true, "caption": "", "figure": { "data": [ { "uid": "3b89bc", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 0, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:add8a8", "zsrc": "markplotly1:8:7085a3", "visible": true, "projection": { "x": { "show": false }, "y": { "show": false } }, "surfaceaxis": -1 }, { "uid": "31d298", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 1, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:5c871a", "zsrc": "markplotly1:8:1b586f" }, { "uid": "307953", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 2, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:0e9ee1", "zsrc": "markplotly1:8:dc0f99" }, { "uid": "0551fc", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 3, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:28ae07", "zsrc": "markplotly1:8:5c42ed" }, { "uid": "7b1aa4", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 4, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:335863", "zsrc": "markplotly1:8:d0869c" }, { "uid": "26ba6f", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 5, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:400670", "zsrc": "markplotly1:8:709f7f" }, { "uid": "6f8bea", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 6, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:55a625", "zsrc": "markplotly1:8:7f91be" }, { "uid": "35be82", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 7, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:3eaafc", "zsrc": "markplotly1:8:4a0d7b" }, { "uid": "4555e2", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 8, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:549934", "zsrc": "markplotly1:8:bf5133" }, { "uid": "f63c6e", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 9, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:bb20e5", "zsrc": "markplotly1:8:29c37e" }, { "uid": "0e24ed", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 10, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:81372f", "zsrc": "markplotly1:8:d60fdb" }, { "uid": "49d27f", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 11, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:7c5e2a", "zsrc": "markplotly1:8:b92889" }, { "uid": "f7c7e1", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 12, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:c2a5cc", "zsrc": "markplotly1:8:b7aed2" }, { "uid": "f92125", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 13, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:2c0e2c", "zsrc": "markplotly1:8:531db9" }, { "uid": "242aae", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 14, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:01d84f", "zsrc": "markplotly1:8:de5c1a" }, { "uid": "373d56", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 15, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:f49bea", "zsrc": "markplotly1:8:e15ea1" }, { "uid": "6a3b68", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 16, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:35d7b3", "zsrc": "markplotly1:8:64e8d1" }, { "uid": "793ea7", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 17, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:4f4a88", "zsrc": "markplotly1:8:fe3e5c" }, { "uid": "c380b6", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 18, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:93f565", "zsrc": "markplotly1:8:a807f9" }, { "uid": "fe934b", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 19, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:1ac0d5", "zsrc": "markplotly1:8:812d69" }, { "uid": "1fc0a6", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 20, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:69ca0c", "zsrc": "markplotly1:8:c0d59f" }, { "uid": "58f171", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 21, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:675151", "zsrc": "markplotly1:8:d4ba27" }, { "uid": "59ce0f", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 22, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:6f14ca", "zsrc": "markplotly1:8:bbf011" }, { "uid": "272d15", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 23, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:75cc6c", "zsrc": "markplotly1:8:9d95be" }, { "uid": "83e6dc", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 24, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:579bc4", "zsrc": "markplotly1:8:f4d371" }, { "uid": "6bae42", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 25, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:25c4b6", "zsrc": "markplotly1:8:f4d371" }, { "uid": "47f3bc", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 26, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:de5931", "zsrc": "markplotly1:8:9d95be" }, { "uid": "164cf5", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 27, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:e51f4d", "zsrc": "markplotly1:8:801918" }, { "uid": "019297", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 28, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:781d03", "zsrc": "markplotly1:8:d4ba27" }, { "uid": "8ce526", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 29, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:88b4c1", "zsrc": "markplotly1:8:c0d59f" }, { "uid": "8c5b1f", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 30, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:5b5d3e", "zsrc": "markplotly1:8:167d58" }, { "uid": "749079", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 31, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:9bc723", "zsrc": "markplotly1:8:5229ed" }, { "uid": "6dedfe", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 32, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:1596d3", "zsrc": "markplotly1:8:fe3e5c" }, { "uid": "de3a4d", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 33, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:d88a2f", "zsrc": "markplotly1:8:64e8d1" }, { "uid": "a879dd", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 34, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:5bea01", "zsrc": "markplotly1:8:e15ea1" }, { "uid": "7359bf", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 35, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:4eab30", "zsrc": "markplotly1:8:2ab676" }, { "uid": "ba128f", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 36, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:38d1ef", "zsrc": "markplotly1:8:531db9" }, { "uid": "450909", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 37, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:0ca9d1", "zsrc": "markplotly1:8:b7aed2" }, { "uid": "b36b53", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 38, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:638ac6", "zsrc": "markplotly1:8:c1e515" }, { "uid": "6a9d4a", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 39, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:558805", "zsrc": "markplotly1:8:75215b" }, { "uid": "750101", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 40, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:ca1620", "zsrc": "markplotly1:8:29c37e" }, { "uid": "2dced1", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 41, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:1ec385", "zsrc": "markplotly1:8:bf5133" }, { "uid": "38d47e", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 42, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:859022", "zsrc": "markplotly1:8:4a0d7b" }, { "uid": "5f6079", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 43, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:7ae591", "zsrc": "markplotly1:8:54e442" }, { "uid": "b95353", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 44, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:ff2a04", "zsrc": "markplotly1:8:c54133" }, { "uid": "654d6d", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 45, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:19d14b", "zsrc": "markplotly1:8:5eb68d" }, { "uid": "6d2590", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 46, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:8b39f9", "zsrc": "markplotly1:8:abe097" }, { "uid": "da8435", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 47, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:7ea969", "zsrc": "markplotly1:8:dc0f99" }, { "uid": "882c20", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 48, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:f721ea", "zsrc": "markplotly1:8:1b586f" }, { "uid": "01642b", "line": { "color": "#0066FF", "width": 2 }, "mode": "lines", "name": "Trace 49, y", "type": "scatter3d", "xsrc": "markplotly1:8:fd560a", "ysrc": "markplotly1:8:b99293", "zsrc": "markplotly1:8:7085a3" } ], "layout": { "scene": { "xaxis": { "type": "linear", "gridcolor": "rgb(255, 255, 255)", "zerolinecolor": "rgb(255, 255, 255)", "showbackground": true, "backgroundcolor": "rgb(230, 230,230)" }, "yaxis": { "type": "linear", "gridcolor": "rgb(255, 255, 255)", "zerolinecolor": "rgb(255, 255, 255)", "showbackground": true, "backgroundcolor": "rgb(230, 230,230)" }, "zaxis": { "type": "linear", "gridcolor": "rgb(255, 255, 255)", "zerolinecolor": "rgb(255, 255, 255)", "showbackground": true, "backgroundcolor": "rgb(230, 230,230)" }, "camera": { "up": { "x": 0, "y": 0, "z": 1 }, "eye": { "x": 0.2443042712383542, "y": 0.20082238733417065, "z": 2.1418416822445354 }, "center": { "x": 0, "y": 0, "z": 0 } }, "aspectratio": { "x": 1, "y": 1, "z": 1 } }, "title": "Wireframe Plot", "width": 1369, "height": 716, "autosize": true, "showlegend": false } }, "height": 716, "width": 1369, "user": { "profile_url": "https://chart-studio.plotly.com/~markplotly1", "avatar_url": "https://storage.googleapis.com/plotly-prod-profiles/45.jpg", "background_url": "https://storage.googleapis.com/plotly-prod-profiles/bg-7.jpg", "bio": "", "nickname": "", "website": "", "stream_tokens": null, "feature_set_id": null, "csrf_token": null, "date_joined": "2015-11-21 17:49:24", "mapbox_access_tokens": null, "has_password": null, "username": "markplotly1", "email": null, "is_active": null, "readonly": null, "is_dash_creator": null, "dash_created_count": null, "is_chart_creator": null, "charts_created_count": null } }
