> ## Documentation Index
> Fetch the complete documentation index at: https://www.forager.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Forager is a REST API for B2B people, company and job post data: contact lookups (phone numbers, personal emails, work emails), person, company and job post search, and bulk data feeds.
> Server: https://api-v2.forager.ai. Send the API key in the X-API-KEY header. Most paths include {account_id}. Read FORAGER_API_KEY and FORAGER_ACCOUNT_ID from the environment; never put the key in client-side code, logs or prompts.
> To add Forager to a project, follow https://www.forager.ai/docs/guides/agent-quickstart.md. To pick an endpoint, read https://www.forager.ai/docs/guides/choose-an-endpoint.md. For end-to-end builds, see https://www.forager.ai/docs/recipes/overview.md.
> Most requests spend credits. Do not guess costs; use https://www.forager.ai/docs/api-overview/credit-pricing.md and ask the user before spending credits.
> Use only endpoints and fields defined in https://www.forager.ai/docs/openapi.yaml. Forager has no MCP server for the API yet; the /mcp endpoint on this site searches the documentation only.

# Amazon S3 data delivery (v2)

> How Forager delivers v2 data feed files to your Amazon S3 bucket: bucket setup, access and file layout.

![S3 data delivery: Forager writes data feed files to your Amazon S3 bucket](https://mintcdn.com/forager/OnhSHNo_LBQ7yKjR/images/illustrations/s3-data-delivery-bucket.svg?fit=max\&auto=format\&n=OnhSHNo_LBQ7yKjR\&q=85\&s=edc14ee38e4cb7fb8177cd42bd9da0c9)

Our preferred mode of data delivery is through **Amazon AWS S3**.

***

## How to Set Up S3 Delivery

To receive data via **S3**, follow these steps:

### 1. Sign Into AWS

Log into the **AWS S3 console**.

### 2. Create an S3 Bucket

* **Create a new bucket** for deliveries (e.g., `s3://YOURCOMPANY-data-deliveries`).

### 3. Create an IAM User and Attach an IAM Policy

To allow **Forager.ai** to send data to your S3 bucket, create an IAM user for Forager in IAM and attach the following **IAM policy** to that user. This is the user whose access keys you send us in step 4. It is an identity-based policy, so add it under **IAM** » **Users** » **Permissions**, not as a bucket policy (S3 rejects a bucket policy without a `Principal`).

#### 📌 **IAM Policy (Replace `YOURCOMPANY-data-deliveries` with your actual bucket name)**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:GetObjectVersion",
                "s3:DeleteObject",
                "s3:DeleteObjectVersion"
            ],
            "Resource": "arn:aws:s3:::YOURCOMPANY-data-deliveries/*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Resource": "arn:aws:s3:::YOURCOMPANY-data-deliveries",
            "Condition": {
                "StringLike": {
                    "s3:prefix": [
                        "*"
                    ]
                }
            }
        }
    ]
}
```

### 4. Provide AWS Access Keys

Once the bucket and IAM user are set up, create an access key for that IAM user and send the following details to Forager.ai:

* Bucket name
* AWS Access Key
* AWS Secret Key

Our team will configure the data delivery to send data directly to your S3 bucket.

## File output paths and file names

Read more about file paths [here](https://www.forager.ai/docs/data-license/v2/output-data-file-details.md).

## Need Help?

📩 For Support: Contact us at [support@forager.ai](mailto:support@forager.ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.