Skip to navigation

Get Ad Platform 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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

platformsstringOptional

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.

idstringOptional
linkedinIDstringOptional
linkedinEntityIdstringOptional
LinkedIn entity ID
linkedinURLstringOptional

LinkedIn public profile URL (linkedin.com/in/)

twitterIDstringOptional
crunchbaseIDstringOptional
angelListIDstringOptional
signalNfxIDstringOptional
polyworkIDstringOptional
emailstringOptional

Response

This endpoint returns an object.
hashedEmailsobject

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

400
Bad Request Error
400
Bad Request Error
401
Unauthorized Error
404
Person Not Found Error
429
Rate Limit Error