# Email Analyzes

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/email/analyzes` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/email-analyzes |

## Description

Analyze a domain to retrieve its email infrastructure. Microsoft 365 and Google Workspace domains, SPF records, and DNS configurations.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/email/analyzes' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Analyze email infrastructure for airbus.com

```json
{
  "domains": {
    "airbus.com": [
      "ag.eu.dmarcadvisor.com",
      "airbus.com",
      "group1._spf.airbus.com",
      "zb85545947.zmverify.zoho.eu",
      "group3._spf.airbus.com",
      "group2._spf.airbus.com",
      "dmarc.airbus.com",
      "group4._spf.airbus.com",
      "spf.airbus.com"
    ],
    "apsys-airbus.com": [
      "ag.eu.dmarcadvisor.com",
      "airbus.com",
      "spf.cloud.vadesecure.com",
      "apsys-airbus.com",
      "report.ssi"
    ],
    "airbus.onmicrosoft.com": [
      "spf.protection.outlook.com"
    ],
    "globalemail.airbus.com": [],
    "airbus.mail.onmicrosoft.com": [
      "outlook.com"
    ]
  },
  "is_microsoft_365": true,
  "is_google_workspace": false,
  "microsoft_365_domains": [
    "airbus.onmicrosoft.com",
    "airbus.mail.onmicrosoft.com"
  ],
  "google_workspace_domains": []
}
```

## Documentation

## Overview
The Email Analyzes endpoint reveals the complete email infrastructure behind any domain. It identifies whether the domain uses Microsoft 365 or Google Workspace, and returns all associated SPF records and DNS configurations.

## Quickstart
```
GET https://api.piloterr.com/v2/email/analyzes?query=airbus.com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The domain to analyze (e.g. `airbus.com`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `domains` | object | Map of domains to their SPF/DNS records |
| `is_microsoft_365` | boolean | Whether the domain uses Microsoft 365 |
| `is_google_workspace` | boolean | Whether the domain uses Google Workspace |
| `microsoft_365_domains` | array | Microsoft 365 domains detected |
| `google_workspace_domains` | array | Google Workspace domains detected |

## Notes
- Analyzes SPF records and DNS to determine email provider.
- Subdomains are automatically detected and included.

## Main use cases
- Identify which email provider a target company uses before outreach
- Map email infrastructure of enterprise domains for security auditing
- Enrich B2B contact data with email provider signals for segmentation
- Validate DNS/SPF configurations for deliverability troubleshooting