The endpoint is https://api.pushshift.io/visualize

This endpoint accepts JSON in the form of either the value of the "data" parameter or, if the request is too large, the body data of the request.

Here is an example using the data parameter in the URL:

http://api.pushshift.io/visualize/?data={"type":"bar","data":[["North Region",32],["South Region",45],["East Region",29],["West Region",54],["International Region",93]],"color":"green","title":{"text":"Regional Sales Report"},"xaxis":{"label":{"text":"Sales Region"}},"yaxis":{"label":{"text":"Sprockets Sold"}}}

This same request can also be done using the request body within a GET request:

curl -s -XGET https://api.pushshift.io/visualize -d '{"type":"bar,"data":[["North Region",32],["South Region",45],["East Region",29],["West Region",54],["International Region",93]],"color":"green","title":{"text":"Regional Sales Report"},"xaxis":{"label":{"text":"Sales Region"}},"yaxis":{"label":{"text":"Sprockets Sold"}}}' > image.png

The purpose of this new endpoint ties in with the new API. All aggregations that can be created with Pushshift will eventually be able to be visualized. On the back end, Pushshift is using the Matplotlib module to create visualizations. Eventually the entire range of Matplotlib graphs will be supported, including support for customization of colors, tick frequency, etc.

The advantage is that this endpoint can be given data and turned into visualizations and eventually animations quickly. The goal is to support thousands of visualizations per second and scale up from there.

Documentation will be created in tandem with development, but here are a few quick examples showing customization options with Python dicts:

data['title']['text'] = "Reddit Graph"
data['xaxis']['label']['text'] = "Subreddit"
data['color'] = '#ff9933'
data['xaxis']['label']['color'] = '#cc6633'
data['xaxis']['ticks']['color'] = '#444444'
data['yaxis']['ticks']['color'] = '#444444'
data['yaxis']['label']['text'] = "Number of Comments"
data['spines']['right']['visible'] = False
data['spines']['top']['visible'] = False