Google Postmaster Tools — Endpoint Reference

Base path: /v1/reputationanalytics/gpt/

Requires domain verification with Google Postmaster Tools before data becomes available.

Endpoints

The API has 5 additional endpoints not listed here. Fetch the OpenAPI spec for the full list.

Common Query Parameters

All data endpoints accept these required query parameters:

• offset (integer) — record number to begin pagination
• limit (integer) — number of records to return
• timeRangeStart (integer) — Unix timestamp start filter
• timeRangeEnd (integer) — Unix timestamp end filter

Response Model (Domain Record)

Each record in the data[] array contains:

• name (string) — domain name
• reputation (int) — Google's domain reputation score
• user_reported_spam_ratio (float) — percentage of mail reported as spam
• spf_success_ratio (float) — SPF authentication pass rate
• dkim_success_ratio (float) — DKIM authentication pass rate
• dmarc_success_ratio (float) — DMARC alignment pass rate
• inbound_encryption_ratio (float) — TLS encryption rate
• delivery_error_ratio (float) — delivery error rate
• delivery_errors[] — array of { error_class, error_type, error_ratio }
• ip_counts[] — array of { reputation, total } per IP reputation band
• feedback_loops[] — array of { id, spam_ratio } per FBL identifier
• date (datetime, nullable) — date of the record

Links

• API docs: https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/inboxready/google-postmaster-tools