Testing sandbox

Use our sample data to get started fast

Faraday requires customer data in order to make predictions. If you're just starting out, you might want to try things out before sending us real data.

That's why we've created a sample file you can use to experience every aspect of the Faraday API. The PII is artificial, but there is real signal in this data.

Account & credentials

Create a free account if you haven't already. You will immediately get an API key that works for testing.

Sample data

Faraday normally operates on the nationwide US adult population. When your account is in test mode, however, it's pointed at the fictional state of Farazona, with a population of around 1 million adults. Residents of Farazona are artificial people whose data closely resembles real-world patterns we find in actual US adults. This ensures that models you build with sample data will exhibit similar performance you will find when operating on real data.

Download

Faraday has selected 50,000 residents of Farazona to serve as customers for the fictitious company Acme. We have sample orders and churn data available for download.

We suggest you follow up by trying one of our quickstarts - Personalizing your outreach or Finding repeat purchasers.

Orders data

You can download sample order data here:

📂 Sample order data

curl -sSLO https://storage.googleapis.com/farazona/acme_orders.csv

You can upload this to your account like this:

curl --request POST \
     --url https://api.faraday.ai/v1/uploads/orders/file1.csv \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer YOUR_API_TOKEN' \
     --header 'Content-Type: application/octet-stream' \
     --verbose \
     --data-binary "@acme_orders.csv"

Then you can describe it to us like this:

curl --request POST \
     --url https://api.faraday.io/v1/datasets \
     --header "Authorization: Bearer YOUR_API_TOKEN" \
     --header "Content-Type: application/json" \
     --data-binary @- <<'EOF'
{
    "upload_directory": "orders",
    "identity_sets": {
        "customer": {
            "person_first_name": "first_name",
            "person_last_name": "last_name",
            "house_number_and_street": ["address"],
            "city": "city",
            "state": "state"
        }
    },
    "output_to_streams": {
        "orders": {
            "data_map": {
                "datetime": {
                    "column_name": "date",
                    "format": "date_iso8601"
                },
                "value": {
                    "column_name": "total",
                    "format": "currency_dollars"
                }
            }
        }
    }
}
EOF

Churn data

You can download sample churn data here:

📂 Sample churn data

curl -sSLO https://storage.googleapis.com/farazona/acme_churns.csv

You can upload this to your account like this:

curl  --request POST \
      --url https://api.faraday.io/v1/uploads/churns/churns1.csv \
      --header "Authorization: Bearer YOUR_API_TOKEN" \
      --header "Content-Type: application/octet-stream" \
      --data-binary "@acme_churns.csv" \

You can describe it to us like this:

curl --request POST \
     --url https://api.faraday.io/v1/datasets \
     --header "Authorization: Bearer YOUR_API_TOKEN" \
     --header "Content-Type: application/json" \
     --data-binary @- <<'EOF'
{
    "upload_directory": "churns",
    "identity_sets": {
        "customer": {
            "person_first_name": "first_name",
            "person_last_name": "last_name",
            "house_number_and_street": ["address"],
            "city": "city",
            "state": "state"
        }
    },
    "output_to_streams": {
        "churns": {
            "data_map": {
                "datetime": {
                    "column_name": "churn_date",
                    "format": "date_iso8601"
                }
            }
        }
    }
}
EOF

How to use real data

Ready to use real data? We will provision a separate API key for that purpose. During our private beta, please fill out this form. You will keep your access to your test account/API key, and all data will be logically isolated per API key.