E-Mail zu MAID

Die E-Mail-zu-MAID-API löst eine E-Mail-Adresse zu einer oder mehreren Mobile Advertising IDs (MAIDs) auf, darunter AAIDs (Android Advertising IDs) und IDFAs (Apple Identifiers for Advertisers).

MAIDs sind das, was Werbeplattformen nutzen, um Nutzer auf ihren mobilen Geräten präzise anzusprechen. Mit diesem Endpunkt verbindest du eine bekannte E-Mail-Identität mit mobilen Gerätesignalen und ermöglichst so geräteübergreifendes Retargeting, programmatische Audience-Aktivierung und mobile-first Ad-Kampagnen gegen deine Kontaktlisten.

Nutze diesen Endpunkt, um:

Mobile Retargeting-Audiences aus deiner Kontaktliste aufzubauen
Programmatische Ad-Kampagnen gegen bekannte Kontakte zu aktivieren
E-Mail-Identitäten mit mobilen Gerätesignalen für geräteübergreifendes Targeting zu verbinden

Fair-Use-Richtlinie: Diese API unterliegt unserer Fair-Use-Richtlinie für Enrichment.

POST https://api.hiwalter.de/api/v1/tools/email_to_maid

Anfrage

Übergib deinen API-Schlüssel als Bearer-Token im Authorization-Header. Schlüssel folgen dem Format hw_XXXXXXXXXXX.

Der Body wird als application/json gesendet.

Parameter	Typ	Beschreibung
`email`	string	E-Mail-Adresse.

Beispiel

curl --request POST \
  --url https://api.hiwalter.de/api/v1/tools/email_to_maid \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "john.smith@example.com"
}
'

Antwort

{
  "results": [
    {
      "device_id": "b8c747bb-96c5-453f-b770-9d64889XXXXX",
      "device_type": "AAID"
    }
  ],
  "status": "ok",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

Feld	Typ	Beschreibung
`results`	array	Liste der gefundenen Mobile Advertising IDs.
`results[].device_id`	string	Die Mobile Advertising ID des Geräts.
`results[].device_type`	string	Typ der MAID, z. B. `AAID` (Android) oder `IDFA` (Apple).
`status`	string	Status der Anfrage, z. B. `ok`.
`metadata.fair_use.records_remaining_5h`	integer	Verbleibende Datensätze im 5-Stunden-Fenster.
`metadata.fair_use.records_reset_5h`	string	Zeitpunkt, an dem das 5-Stunden-Fenster zurückgesetzt wird.
`metadata.fair_use.records_remaining_1w`	integer	Verbleibende Datensätze im 1-Wochen-Fenster.
`metadata.fair_use.records_reset_1w`	string	Zeitpunkt, an dem das 1-Wochen-Fenster zurückgesetzt wird.