Submit SpiderVerify Job

POST/api/v1/jobs/spiderVerify/submit

Overview

SpiderVerify validates email addresses at the SMTP level to determine deliverability without sending actual emails. It can verify single emails or bulk batches of up to 100 emails per request.

Request Body

payloadobjectrequired

Verification parameters

payload.emailstring

Single email to verify. Either email or emails is required.

payload.emailsarray

Array of emails to verify (max 100). Either email or emails is required.

payload.check_gravatarbooleandefault: false

Check if email has a Gravatar profile

payload.check_dnsblbooleandefault: false

Check email domain against DNSBL blacklists

payload.smtp_timeout_secsintegerdefault: 10

SMTP connection timeout in seconds

payload.fuzziq_enabledboolean

Enable FuzzIQ deduplication for this job (v2.18.0+)

When enabled, each verified email will include a fuzziq_unique flag indicating whether it's a new record or duplicate.

Default: Uses client-level setting (typically true)

payload.fuzziq_unique_onlyboolean

Return only unique records, filtering out duplicates (v2.18.0+)

When true, emails that are duplicates of previously verified records will be excluded from the response.

Default: Uses client-level setting (typically false)

priorityintegerdefault: 5

Job priority (0-10, higher = processed first)

Single Email Verification

cURL

curl -X POST https://spideriq.ai/api/v1/jobs/spiderVerify/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "payload": {
      "email": "john@example.com"
    },
    "priority": 5
  }'

Python

import requests

headers = {
    "Authorization": "Bearer <your_token>",
    "Content-Type": "application/json"
}

data = {
    "payload": {
        "email": "john@example.com"
    },
    "priority": 5
}

response = requests.post(
    "https://spideriq.ai/api/v1/jobs/spiderVerify/submit",
    headers=headers,
    json=data
)

print(response.json())

JavaScript

const response = await fetch(
  'https://spideriq.ai/api/v1/jobs/spiderVerify/submit',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer <your_token>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      payload: {
        email: 'john@example.com'
      },
      priority: 5
    })
  }
);

const data = await response.json();
console.log(data);

Bulk Email Verification

Verify up to 100 emails in a single request:

cURL

curl -X POST https://spideriq.ai/api/v1/jobs/spiderVerify/submit \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <client_id>:<api_key>:<api_secret>" \
  -d '{
    "payload": {
      "emails": [
        "john@example.com",
        "jane@company.com",
        "info@business.org"
      ]
    },
    "priority": 5
  }'

Python

import requests

headers = {
    "Authorization": "Bearer <your_token>",
    "Content-Type": "application/json"
}

data = {
    "payload": {
        "emails": [
            "john@example.com",
            "jane@company.com",
            "info@business.org"
        ]
    },
    "priority": 5
}

response = requests.post(
    "https://spideriq.ai/api/v1/jobs/spiderVerify/submit",
    headers=headers,
    json=data
)

print(response.json())

Response

Job Submitted Successfully

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "spiderVerify",
  "status": "queued",
  "created_at": "2025-12-22T10:30:00Z",
  "from_cache": false,
  "message": "Job submitted successfully and queued for processing"
}

Completed Job Result (Single Email)

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "spiderVerify",
  "status": "completed",
  "processing_time_seconds": 2.5,
  "worker_id": "spiderverify-llm5",
  "completed_at": "2025-12-22T10:30:02Z",
  "data": {
    "email": "john@example.com",
    "status": "valid",
    "quality_score": 95,
    "is_deliverable": true,
    "is_disposable": false,
    "is_role_account": false,
    "is_free": true,
    "is_catch_all": false,
    "domain": {
      "name": "example.com",
      "has_mx": true,
      "mx_records": ["mx.example.com"]
    },
    "smtp": {
      "can_connect": true,
      "is_catch_all": false
    }
  }
}

Completed Job Result (Bulk)

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "spiderVerify",
  "status": "completed",
  "processing_time_seconds": 8.2,
  "data": {
    "results": [
      {
        "email": "john@example.com",
        "status": "valid",
        "quality_score": 95,
        "is_deliverable": true
      },
      {
        "email": "jane@company.com",
        "status": "valid",
        "quality_score": 88,
        "is_deliverable": true
      },
      {
        "email": "fake@nonexistent.xyz",
        "status": "invalid",
        "quality_score": 0,
        "is_deliverable": false
      }
    ],
    "summary": {
      "total": 3,
      "valid": 2,
      "invalid": 1,
      "risky": 0,
      "unknown": 0
    }
  }
}

Status Values

Status	Description
valid	Email is deliverable
invalid	Email does not exist or is not deliverable
risky	Email may be deliverable but has risk factors (catch-all, disposable)
unknown	Could not determine status (timeout, greylisting)

Quality Score

The quality_score (0-100) indicates email quality:

Score	Meaning
90-100	Excellent - Verified deliverable
70-89	Good - Likely deliverable
50-69	Fair - Some risk factors present
25-49	Poor - High risk
0-24	Bad - Invalid or undeliverable

Boolean Flags

Flag	Description
is_deliverable	Email can receive messages
is_disposable	Temporary/throwaway email service
is_role_account	Generic role address (info@, support@)
is_free	Free email provider (Gmail, Yahoo, etc.)
is_catch_all	Domain accepts all emails

Rate Limits

• 3 seconds between verifications (automatic)
• 100 emails maximum per bulk request
• 5,000 jobs maximum queue depth

note

SpiderVerify uses email rotation across 10 VPS with 50 warmed emails to protect sender reputation.