Quick Start

Get up and running with GTMData in under 2 minutes. Validate an email or find someone's work email with just an API key and a single request.

1. Get Your API Key

Sign up at app.gtmdata.com and navigate to Settings → API Keys. Click Create Key to generate a key that starts with gtm_live_. You get 100 free credits instantly — no credit card required.

Tip: Keep your API key secret. Never expose it in client-side code or public repositories.

2. Validate an Email

Send a POST request to /v1/validate with the email you want to verify. This costs 0.25 credits for a valid result.

cURL

curl -X POST https://api.gtmdata.co/v1/validate \
  -H "Authorization: Bearer gtm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email":"tim@apple.com"}'

Python

import requests

resp = requests.post(
    "https://api.gtmdata.co/v1/validate",
    headers={"Authorization": "Bearer gtm_live_your_key"},
    json={"email": "tim@apple.com"},
)
print(resp.json())

JavaScript

const resp = await fetch("https://api.gtmdata.co/v1/validate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer gtm_live_your_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email: "tim@apple.com" }),
});
const data = await resp.json();
console.log(data);

Response

{
  "email": "tim@apple.com",
  "status": "valid",
  "provider": "other"
}

3. Find an Email

Don't have the email? Use /v1/find with a name and company domain. GTMData tries 16 naming conventions and SMTP-verifies each. Costs 1 credit for a valid result.

cURL

curl -X POST https://api.gtmdata.co/v1/find \
  -H "Authorization: Bearer gtm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Tim","last_name":"Cook","domain":"apple.com"}'

Python

import requests

resp = requests.post(
    "https://api.gtmdata.co/v1/find",
    headers={"Authorization": "Bearer gtm_live_your_key"},
    json={"first_name": "Tim", "last_name": "Cook", "domain": "apple.com"},
)
print(resp.json())

JavaScript

const resp = await fetch("https://api.gtmdata.co/v1/find", {
  method: "POST",
  headers: {
    "Authorization": "Bearer gtm_live_your_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    first_name: "Tim",
    last_name: "Cook",
    domain: "apple.com",
  }),
});
const data = await resp.json();
console.log(data);

Response

{
  "email": "tcook@apple.com",
  "status": "valid",
  "provider": "other",
  "convention": "flast",
  "confidence": 1
}

Next Steps

You're ready to go. Check out the Validate and Find endpoint docs for full parameter references, or jump to Batch and Jobs to process lists at scale.