Google Account Checker & Intelligence API

A lightweight, enterprise-grade OSINT API to verify Google account existence, deliverability status, and diagnostic state (active vs. suspended, consumer Gmail vs. Google Workspace custom domain mailboxes) by email address, username, or phone number.

Table of Contents

• Features
• Getting Started
  • 1. Get API Key
  • 2. Base URL & Authentication
• API Endpoints
  • Single Account Check
  • Code Examples
• Response Format
• HTTP Status Codes
• Requirements
• Pricing
• Support
• Legal Compliance

---

Features

✅ Instant Verification: Real-time presence verification for Google Accounts and Gmail mailboxes.
✅ Multi-Identifier Support: Query by email address, username handle, or E.164 international phone number.
✅ Domain & Workspace Support: Works seamlessly across @gmail.com and custom Google Workspace domains.
✅ Diagnostic Status & Deliverability: Flags suspended, disabled, or security-restricted accounts in the note field.
✅ Profile Metadata Extraction: On phone number checks, retrieves account presence, formatted display name, profile avatar URL, and custom avatar status.
✅ High Performance: Asynchronous architecture with high-speed proxy cycling and warm worker daemons.
✅ Developer-Friendly: Available via direct REST API on OSINT Trace (Recommended) and major developer marketplaces.

---

Getting Started

1. Get API Key

• OSINT Trace Direct (Recommended): Create an account on OSINT Trace and generate your API Key from the Workspace Dashboard.
• API.Market: Subscribe via API.Market Google Checker.
• RapidAPI: Subscribe via RapidAPI Google Checker.

2. Base URL & Authentication

Authentication headers and endpoints vary by provider:

Provider	Base URL	Auth Header	Endpoint
OSINT Trace (Direct - Recommended)	https://api.osinttrace.com/v1	x-osint-key: YOUR_OSINT_KEY	POST /check/google
API.Market	https://prod.api.market/api/v1/osint-trace-1/google-checker	X-Api-Key: YOUR_API_KEY	POST /check/google
RapidAPI	https://google-checker2.p.rapidapi.com	X-RapidAPI-Key: YOUR_API_KEY X-RapidAPI-Host: google-checker2.p.rapidapi.com	POST /check

---

API Endpoints

Single Account Check

Endpoint (OSINT Trace Direct - Recommended):

POST https://api.osinttrace.com/v1/check/google

Request Body (Email or Username):

{
  "input": "target@gmail.com"
}

Request Body (Phone Number):

{
  "input": "+14155552671"
}

Code Examples

OSINT Trace Direct API (cURL) — Recommended

# Verify by Email or Username
curl --request POST \
     --url https://api.osinttrace.com/v1/check/google \
     --header 'x-osint-key: YOUR_OSINT_KEY' \
     --header 'Content-Type: application/json' \
     --data '{"input": "target@gmail.com"}'

# Verify by Phone Number (E.164 format)
curl --request POST \
     --url https://api.osinttrace.com/v1/check/google \
     --header 'x-osint-key: YOUR_OSINT_KEY' \
     --header 'Content-Type: application/json' \
     --data '{"input": "+14155552671"}'

API.Market (cURL)

curl --request POST \
     --url https://prod.api.market/api/v1/osint-trace-1/google-checker/check/google \
     --header 'X-Api-Key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{"input": "+14155552671"}'

RapidAPI (cURL)

curl --request POST \
     --url https://google-checker2.p.rapidapi.com/check \
     --header 'X-RapidAPI-Host: google-checker2.p.rapidapi.com' \
     --header 'X-RapidAPI-Key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{"input": "+14155552671"}'

Additional code snippets for Python, Node.js, Go, PHP, C#, Java, and Shell are available in the examples/ directory.

---

Response Format

Active Account Found (Email / Username)

{
  "live": true,
  "note": null
}

Active Account Found by Phone (with Metadata)

{
  "live": true,
  "note": "",
  "metadata": {
    "name": "+1 415 555 2671",
    "avatar_url": "https://lh3.googleusercontent.com/a/ACg8oc...",
    "has_custom_avatar": false
  }
}

Suspended Account Found

{
  "live": true,
  "note": "suspended"
}

Account Not Found

{
  "live": false,
  "note": null
}

---

HTTP Status Codes

Status Code	Description	Rationale
200 OK	Success	Query processed and presence/diagnostic state returned.
400 Bad Request	Validation Error	Malformed request body or input under minimum length.
401 Unauthorized	Authentication Required	Missing, invalid, or expired API key header.
403 Forbidden	Quota / Subscription Error	Quota balance exhausted or subscription inactive.
408 Request Timeout	Timeout	Upstream verification exceeded maximum execution window.
429 Too Many Requests	Rate Limit Exceeded	Exceeded 1 request/second limit.

---

Requirements

• Minimum input length: 3 characters
• Supported input formats:
  • Email addresses (user@gmail.com, user@custom-workspace-domain.com)
  • Usernames (john_doe)
  • Phone numbers in international standard E.164 format (+14155552671, +212612423061)
• Rate Limit: 1 request per second per active API key.

---

Pricing

• Direct Plans (Recommended): Flexible subscription tiers and bulk volume pricing available on OSINT Trace Pricing.
• Marketplace Plans: Subscriptions also available through API.Market and RapidAPI.
• Free Tier: Free tier available for evaluation and testing.

---

Support

For technical inquiries, enterprise SLA plans, or integration assistance:
📧 Email: support@osinttrace.com
🌐 Website: osinttrace.com

---

Legal Compliance

This API is designed for legitimate cybersecurity investigation, fraud prevention, email deliverability hygiene, and threat intelligence. Users must:

• Comply with applicable local and international data protection regulations (e.g., GDPR, CCPA).
• Adhere to Google's Terms of Service and acceptable use policies.
• Ensure lawful basis for investigative data processing.

This service is independently operated by OSINT Trace and is not affiliated with or endorsed by Alphabet Inc. or Google LLC.