Data Delivery Using S3

Our preferred mode of delivery is through Amazon’s AWS S3 service. To set up this delivery, do the following:

Sign into the AWS S3 console.
Create a bucket for deliveries (for example, s3://YOURCOMPANY-data-deliveries).
1. If you are using an existing bucket, ensure that Requester Pays is disabled.
Modify the bucket policy in the Permissions tab.
Paste the following into your permissions and replace {{your bucket name}} with your new bucket name (for example, YOURCOMPANY-data-deliveries) and click Save.

JSON

{
    "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}}/*"
            ]
        }
    ]
}

Email success@peopledatalabs.com with your bucket URL.

Delivery Completion Files

All Data License S3 deliveries include a top-level COMPLETED file once the full delivery is completely written. Use this file as the reliable trigger for ingestion or downstream automation. You may also see _SUCCESS files inside individual folders. These are internal PDL markers for subdirectory processing and should not be used to decide whether the overall delivery is ready. For full guidance on delivery signals, see Data License Ingestion.

Note on S3 Saving

When you click Save on the Bucket Policy page, AWS may not provide a “Saved” notification message and may also display the following:

This is a standard AWS message but for some it can be confusing. To confirm the new policy above is saved, refresh the page and check if the policy is still there.

Note on Data Delivery & IAM

Per best practices, we do not support the use of IAM users for data delivery. IAM users utilize Access Keys / Secret Access Keys and would need to be rotated regularly. The best practice is to use roles with the policy described above, which allows our PDL role to deliver the data to you.

General

API Overview

Person Data

Person APIs

Company Data

Company APIs

IP Data

IP API

Job Posting Data

Job Posting API

Supporting APIs

Data Standardization

Free Datasets

Libraries

Integrations

Resources

Data License

Support

Delivery Completion Files

Note on S3 Saving

Note on Data Delivery & IAM

​Delivery Completion Files

​Note on S3 Saving

​Note on Data Delivery & IAM

Delivery Completion Files

Note on S3 Saving

Note on Data Delivery & IAM