> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.data.aviato.co/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.data.aviato.co/_mcp/server.

# Get Ad Platform Email Hashes

GET https://data.api.aviato.co/person/ad-email-hashes

Get a person's personal email addresses hashed for ad-platform audience matching (customer lists, matched audiences, conversion APIs).

Returns the same emails as `/person/email-hash`. Each platform expects emails normalized in its own way before hashing, and a hash of a differently normalized address can never match, so this endpoint normalizes each email the way each requested platform specifies and returns the hashes in the encoding that platform expects, ready to upload as-is. Hashes that come out identical after normalization are returned once.

Priced the same as `/person/email-hash`: one charge per lookup that returns at least one hash, however many platforms are requested.

Reference: https://docs.data.aviato.co/api-reference/person/get-ad-platform-email-hashes

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Query parameters

- `platforms` (string, optional) — Comma-separated platforms to return hashes for, or `all` (the default). Values: `google`, `meta`, `linkedin`, `x`, `reddit`, `microsoft`, `vibe`, `tiktok`, `snapchat`, `pinterest`, `amazon`, `nextdoor`, `criteo`, `taboola`, `liveramp`, `yahoo`, `spotify`, `viant`, `mntn`, `zeta`, `adobe`, `roku`, `quora`, `adroll`, `stackadapt`, `uid2`. Aliases: `facebook` and `instagram` for `meta`, `twitter` for `x`, `bing` for `microsoft`, `liveintent` for `zeta`, `rollworks` and `nextroll` for `adroll`, `ttd` and `thetradedesk` for `uid2`.
- `id` (string, optional)
- `linkedinID` (string, optional)
- `linkedinEntityId` (string, optional) — LinkedIn entity ID
- `linkedinURL` (string, optional) — LinkedIn public profile URL (linkedin.com/in/)
- `twitterID` (string, optional)
- `crunchbaseID` (string, optional)
- `angelListID` (string, optional)
- `signalNfxID` (string, optional)
- `polyworkID` (string, optional)
- `email` (string, optional)

## Response

### 200

- `hashedEmails` (PersonAdPlatformEmailHashes, required) — Hashed emails per requested platform. Only the requested platforms are present; a platform with no hashes has an empty list. - `google`: Google Ads Customer Match and Enhanced Conversions. Trimmed and lowercased; for gmail.com and googlemail.com addresses, dots and any `+suffix` are removed from the local part. - `meta`: Facebook / Instagram Custom Audiences and the Conversions API `em` field. Trimmed and lowercased. - `linkedin`: LinkedIn Matched Audiences and the Conversions API. Lowercased with all whitespace removed. - `x`: X (Twitter) Custom Audiences and the Conversion API. Trimmed and lowercased. - `reddit`: Reddit customer-list audiences, advanced matching and the Conversions API. Trimmed and lowercased; dots and any `+suffix` are removed from the local part on every domain. - `microsoft`: Microsoft Advertising (Bing) Customer Match. Trimmed and lowercased. Microsoft's UET Conversions API `em` field instead expects dots and any `+suffix` removed on every domain, which is the `reddit` format. - `vibe`: Vibe CTV audience uploads. Lowercased with all whitespace removed. - `tiktok`: TikTok customer-file audiences and the Events API. Trimmed and lowercased. - `snapchat`: Snapchat customer-list segments and the Conversions API. Trimmed and lowercased. - `pinterest`: Pinterest customer-list audiences and the Conversions API. Trimmed and lowercased. - `amazon`: Amazon DSP hashed audiences, Amazon Marketing Cloud and the Events API. Trimmed and lowercased, keeping only letters, digits, `.`, `@` and `-`. - `nextdoor`: Nextdoor custom audiences and the Conversions API. Trimmed and lowercased. - `criteo`: Criteo contact-list audiences. Trimmed and lowercased. - `taboola`: Taboola audience onboarding. Trimmed and lowercased. - `liveramp`: LiveRamp onboarding (RampID). Lowercased with all whitespace removed. - `yahoo`: Yahoo DSP audiences, ConnectID and the Conversion API. Trimmed and lowercased. - `spotify`: Spotify Ads customer lists. Trimmed and lowercased; for gmail.com addresses, dots and any `+suffix` are removed from the local part. - `viant`: Viant DSP audiences and the Conversions API. Lowercased with all whitespace removed. - `mntn`: MNTN CRM audiences. Trimmed and lowercased. - `zeta`: Zeta Global / LiveIntent audiences. Lowercased with all whitespace removed. - `adobe`: Adobe Advertising DSP (Email_LC_SHA256). Trimmed and lowercased. - `roku`: Roku customer lists. Trimmed and lowercased. - `quora`: Quora list match. Lowercased with all whitespace removed. - `adroll`: AdRoll / RollWorks customer lists. Trimmed and lowercased. **MD5**, lowercase hex. - `stackadapt`: StackAdapt CRM lists. Trimmed and lowercased. **SHA-1**, lowercase hex. - `uid2`: The Trade Desk Unified ID 2.0 and EUID hashed-email input. Trimmed and lowercased; for gmail.com addresses, dots and any `+suffix` are removed from the local part. Base64-encoded. Every hash is SHA-256 as lowercase hex unless noted. Where a platform accepts several hash types, one of them is returned.

## Errors

### 404 Person Not Found Error

### 400 Bad Request Error

- `message` (string, required)

### 401 Unauthorized Error

### 429 Rate Limit Error

### 400 Bad Request Error

- `message` (string, required)

## Types

### PersonAdPlatformEmailHashes

Hashed emails per requested platform. Only the requested platforms are present; a platform with no hashes has an empty list. - `google`: Google Ads Customer Match and Enhanced Conversions. Trimmed and lowercased; for gmail.com and googlemail.com addresses, dots and any `+suffix` are removed from the local part. - `meta`: Facebook / Instagram Custom Audiences and the Conversions API `em` field. Trimmed and lowercased. - `linkedin`: LinkedIn Matched Audiences and the Conversions API. Lowercased with all whitespace removed. - `x`: X (Twitter) Custom Audiences and the Conversion API. Trimmed and lowercased. - `reddit`: Reddit customer-list audiences, advanced matching and the Conversions API. Trimmed and lowercased; dots and any `+suffix` are removed from the local part on every domain. - `microsoft`: Microsoft Advertising (Bing) Customer Match. Trimmed and lowercased. Microsoft's UET Conversions API `em` field instead expects dots and any `+suffix` removed on every domain, which is the `reddit` format. - `vibe`: Vibe CTV audience uploads. Lowercased with all whitespace removed. - `tiktok`: TikTok customer-file audiences and the Events API. Trimmed and lowercased. - `snapchat`: Snapchat customer-list segments and the Conversions API. Trimmed and lowercased. - `pinterest`: Pinterest customer-list audiences and the Conversions API. Trimmed and lowercased. - `amazon`: Amazon DSP hashed audiences, Amazon Marketing Cloud and the Events API. Trimmed and lowercased, keeping only letters, digits, `.`, `@` and `-`. - `nextdoor`: Nextdoor custom audiences and the Conversions API. Trimmed and lowercased. - `criteo`: Criteo contact-list audiences. Trimmed and lowercased. - `taboola`: Taboola audience onboarding. Trimmed and lowercased. - `liveramp`: LiveRamp onboarding (RampID). Lowercased with all whitespace removed. - `yahoo`: Yahoo DSP audiences, ConnectID and the Conversion API. Trimmed and lowercased. - `spotify`: Spotify Ads customer lists. Trimmed and lowercased; for gmail.com addresses, dots and any `+suffix` are removed from the local part. - `viant`: Viant DSP audiences and the Conversions API. Lowercased with all whitespace removed. - `mntn`: MNTN CRM audiences. Trimmed and lowercased. - `zeta`: Zeta Global / LiveIntent audiences. Lowercased with all whitespace removed. - `adobe`: Adobe Advertising DSP (Email_LC_SHA256). Trimmed and lowercased. - `roku`: Roku customer lists. Trimmed and lowercased. - `quora`: Quora list match. Lowercased with all whitespace removed. - `adroll`: AdRoll / RollWorks customer lists. Trimmed and lowercased. **MD5**, lowercase hex. - `stackadapt`: StackAdapt CRM lists. Trimmed and lowercased. **SHA-1**, lowercase hex. - `uid2`: The Trade Desk Unified ID 2.0 and EUID hashed-email input. Trimmed and lowercased; for gmail.com addresses, dots and any `+suffix` are removed from the local part. Base64-encoded. Every hash is SHA-256 as lowercase hex unless noted. Where a platform accepts several hash types, one of them is returned.

- `google` (list of string, optional)
- `meta` (list of string, optional)
- `linkedin` (list of string, optional)
- `x` (list of string, optional)
- `reddit` (list of string, optional)
- `microsoft` (list of string, optional)
- `vibe` (list of string, optional)
- `tiktok` (list of string, optional)
- `snapchat` (list of string, optional)
- `pinterest` (list of string, optional)
- `amazon` (list of string, optional)
- `nextdoor` (list of string, optional)
- `criteo` (list of string, optional)
- `taboola` (list of string, optional)
- `liveramp` (list of string, optional)
- `yahoo` (list of string, optional)
- `spotify` (list of string, optional)
- `viant` (list of string, optional)
- `mntn` (list of string, optional)
- `zeta` (list of string, optional)
- `adobe` (list of string, optional)
- `roku` (list of string, optional)
- `quora` (list of string, optional)
- `adroll` (list of string, optional)
- `stackadapt` (list of string, optional)
- `uid2` (list of string, optional)

## Examples

**Response**

```json
{
  "hashedEmails": {
    "google": [
      "google",
      "google"
    ],
    "meta": [
      "meta",
      "meta"
    ],
    "linkedin": [
      "linkedin",
      "linkedin"
    ],
    "x": [
      "x",
      "x"
    ],
    "reddit": [
      "reddit",
      "reddit"
    ],
    "microsoft": [
      "microsoft",
      "microsoft"
    ],
    "vibe": [
      "vibe",
      "vibe"
    ],
    "tiktok": [
      "tiktok",
      "tiktok"
    ],
    "snapchat": [
      "snapchat",
      "snapchat"
    ],
    "pinterest": [
      "pinterest",
      "pinterest"
    ],
    "amazon": [
      "amazon",
      "amazon"
    ],
    "nextdoor": [
      "nextdoor",
      "nextdoor"
    ],
    "criteo": [
      "criteo",
      "criteo"
    ],
    "taboola": [
      "taboola",
      "taboola"
    ],
    "liveramp": [
      "liveramp",
      "liveramp"
    ],
    "yahoo": [
      "yahoo",
      "yahoo"
    ],
    "spotify": [
      "spotify",
      "spotify"
    ],
    "viant": [
      "viant",
      "viant"
    ],
    "mntn": [
      "mntn",
      "mntn"
    ],
    "zeta": [
      "zeta",
      "zeta"
    ],
    "adobe": [
      "adobe",
      "adobe"
    ],
    "roku": [
      "roku",
      "roku"
    ],
    "quora": [
      "quora",
      "quora"
    ],
    "adroll": [
      "adroll",
      "adroll"
    ],
    "stackadapt": [
      "stackadapt",
      "stackadapt"
    ],
    "uid2": [
      "uid2",
      "uid2"
    ]
  }
}
```

**SDK Code**

```python
import requests

url = "https://data.api.aviato.co/person/ad-email-hashes"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://data.api.aviato.co/person/ad-email-hashes';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data.api.aviato.co/person/ad-email-hashes"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://data.api.aviato.co/person/ad-email-hashes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://data.api.aviato.co/person/ad-email-hashes")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://data.api.aviato.co/person/ad-email-hashes', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://data.api.aviato.co/person/ad-email-hashes");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://data.api.aviato.co/person/ad-email-hashes")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```