How can we help you?
How to Integrate Pearl Diver With AWS S3
Export raw web and intent data from Pearl Diver directly into an Amazon S3 bucket for further processing.

This integration is designed for developers who need a secure, automated way to move data from Pearl Diver into their AWS infrastructure for further processing or analysis.

✅ Prerequisites

  • An AWS account with permissions to create and access S3 buckets.
  • An AWS Access Key ID and Secret Access Key with s3:PutObject permissions.
  • An existing S3 bucket to receive the data.

⚡ What you can do

  • Export raw web and intent data to AWS S3.
  • Authenticate securely with your AWS access and secret keys.
  • Configure exports at the bucket level for targeted storage.
  • Export high volumes of data, with your audience data staying in sync between Pearl Diver and S3.

🛠️ Set up the integration

  1. Log in to Pearl Diver.
  2. Go to Actions.
  3. Click the AWS S3 action to open the integration configuration screen.
  4. Under Action Configuration, enter your Bucket name (must exist and be accessible to your credentials), Access key (your AWS Access Key ID, with write access to the bucket), and Secret (your AWS Secret Access Key, kept confidential).AWS S3 action configuration fields for bucket name, access key, and secret
  5. Click Authorize to validate and connect the integration.

Note: The access key and secret you use must have s3:PutObject permission for the target bucket.

Add audience configuration

Once authorized, choose which Pearl Diver audiences export their data to the connected S3 bucket.

  • Under Audience Configuration, select one or more audiences to connect.
  • Click Update to save.

🔍 Where it appears in S3

Each audience uploads to a folder named audienceName_audienceKey, inside a parent folder named for the audience type: web or intent.

S3 bucket folder structure showing web and intent parent foldersAn audience folder inside S3 named with its audience key

Need Help?

Email us at [email protected] with your account details and a brief description of what you need help with.

Did this answer your question?
Ask AI
Responses are generated using AI and may contain mistakes.
How can I help you?
Ask me anything about our product. I can help you find answers across the knowledge base.
Ask a question...Ctrl+I