The PeopleDataLabs Developer Hub

Welcome to the PeopleDataLabs developer hub. You'll find comprehensive guides and documentation to help you start working with PeopleDataLabs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Changelog

Receiving and Updating Data

Receiving the Data

You can receive your license delivery updates via AWS's S3 Service, Google Cloud's Cloud Storage service, or via a list of presigned URLs you can use to download the data directly.

Follow the instructions for one of the data delivery methods below to begin receiving data.

S3

Our preferred mode of delivery is via Amazon's AWS S3 service.

To set up for delivery:

  1. Sign into AWS S3 console
  2. Create a bucket for deliveries (e.g. s3://YOURCOMPANY-data-deliveries)
  3. Modify the bucket policy in the permissions tab
  4. Paste the following into your permissions and replace {{your bucket name}} with your new bucket name (something like YOURCOMPANY-data-deliveries) and hit save.
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "People Data Labs Bucket Permissions",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::556708831556:role/pdl-customer-deliveries"
            },
            "Action": [
                "s3:ListBucket",
                "s3:GetObject",
                "s3:PutObject",
                "s3:ListBucketMultipartUploads",
                "s3:ListMultipartUploadParts",
                "s3:AbortMultipartUpload",
                "s3:DeleteObject",
                "s3:GetBucketAcl",
                "s3:GetBucketPublicAccessBlock",
                "s3:GetBucketPolicyStatus"
            ],
            "Resource": [
                "arn:aws:s3:::{{your bucket name}}",
                "arn:aws:s3:::{{your bucket name}}/*"
            ]
        }
    ]
}
  1. Email [email protected] with your bucket URL.

Note on S3 Saving

When you hit Save on the Bucket Policy page, AWS may not give a "Saved" notification message and also show the following message:

This message is normal for AWS but can be confusing. To confirm the new policy above is saved, refresh the page and see if the policy is still there.

Direct Download

If you're unable to receive the data via AWS or Google Cloud, you may opt to receive your data as a list of temporary presigned URLs.

When a new version of the dataset is ready for you to ingest, we'll send you an email, letting you know your the dataset is ready for you to download. Once you email us back, confirming that you're ready to begin downloading the data, we'll send you a new-line separated text file of presigned urls. Each URL can be downloaded via a simple HTTP call.

Each presigned URL is only valid for 7 days after being generated. If you're unable to download the data within this span of time, email [email protected] and we'll generate a new set of presigned URLs for your delivery.

Google Cloud

Coming soon

Updated 16 days ago


Receiving and Updating Data


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.