​
1. Get Your API Key

Go to this page and click the New API Key button. Copy and save the key to a secure place.

​
2. Create a Dataset

Before you can start your job, you need to create a dataset. You can do that with the Upsert Dataset endpoint. Because you are creating a new dataset, be sure to pass id_column and name in the request body.

Make sure to take note of the dataset_id in the response as you'll need it for starting a job with the API. You can always get the dataset_id by using the Get Datasets endpoint.

​
3. Start a Transform Job

Once your dataset has been created, it’s time to kick off a transform job. You can do that with the Start Transform Job endpoint. Because you are creating a new transform job, be sure to pass in the dataset_id, name, and user_instructions parameters in the body.

Since transforming can take a while, the system will return a response that contains the job_id, which you can then use to poll for the status of the job with the Get Transform Job Status endpoint. Alternatively you can pass in a callback_url to the Start Transform Job request and the system will POST a request there once it is complete.

​
4. Retrieving Your Transformations

Once a transform job is complete, you can call the Get All Transforms endpoint with the job_id from the previous step.

When retrieving results with the api, the response will be paginated. Here's an example of how you can handle that in python to retrieve all of the results:

import requests

page = 1
data = []
while page is not None:
    response = requests.get(
        f"https://app.getaugerdata.com/api/v1/{job_type}/all/{job_id}?page={page}",
        headers={"Authorization": "Bearer xxxxx"},
    )
    response.raise_for_status()
    response = response.json()
    page += 1
    data.extend(response['results'])
    if page > response['pagination']['total_pages']:
        page = None
OverviewApplication