Using Spotless with Python

You can easily use Spotless in your python applications by using the pyspotless library.

The code is open source and you can download it here:

You can also view detail on pypi:


You can install pyspotless by running

pip install pyspotless


1. Get your access token by going to when you are logged in
2. Get the URL of a plan you want to run from
3. Write the following python code:

from pyspotless import SpotlessClient

spotless = SpotlessClient(access_token='<SPOTLESS TOKEN HERE>')

def callback(job, id):
    clean_file = spotless.get_processed_file(job)
    # now do something with the file

spotless.run_job("<PLAN ID HERE>", "my_dirty_file.csv", callback, "my identifier")

4. Do some cleansing