Understanding Qualification Results

This document explains how to interpret the results from Fuego’s lead qualification API. Understanding these results will help you implement appropriate logic in your applications and make better decisions based on the data.

Result Summary

The API provides multiple data points to help you qualify and understand each lead:

1. Email Format Validation - Is the email syntax valid?
2. Domain Validation - Does the domain have valid MX records?
3. Free Email Detection - Is the email from a free provider like Gmail?
4. Disposable Email Detection - Is this a temporary or throwaway email?
5. Typo Suggestions - Corrections for common typos in email domains
6. Domain Intelligence - Detailed company information for business domains

Email Format and Domain Validation

These fields provide basic validation about the email address:

{
  "email": "alex@techcorp.com",
  "valid_format": true,
  "valid_mx": true
}

• valid_format: Boolean indicating whether the email address format is syntactically valid
• valid_mx: Boolean indicating whether the email domain has valid MX records for receiving email

⚠️ Important: Even if an email passes both of these basic checks, it doesn’t guarantee the specific email address exists. It only confirms the domain is capable of receiving email.

Free and Disposable Email Detection

{
  "free": false,
  "disposable": false
}

• free: Boolean indicating whether the email uses a free provider (Gmail, Yahoo, Hotmail, etc.)
• disposable: Boolean indicating whether the email uses a disposable or temporary service

These fields help you identify potentially lower-quality leads. Free email addresses may indicate non-business users, while disposable emails often signal that a user doesn’t want to be contacted.

Typo Detection

{
  "did_you_mean": "alex@gmail.com"
}

The did_you_mean field provides suggested corrections for common email typos. This is especially useful for forms where users might make typing mistakes. If no typo is detected, this field is null.

Common corrections include:

• Domain typos (gmial.com → gmail.com)
• TLD errors (gmail.co → gmail.com)
• Transposed letters (yahooo.com → yahoo.com)

Domain Intelligence

For business domains, Fuego provides detailed company information:

{
  "domain_insight": {
    "category": "organization",
    "name": "TechCorp Inc.",
    "industry": "Software Development",
    "country": "US",
    "ticker": "TCH",
    "employees": 3500,
    "description": "TechCorp Inc. is a leading software development company specializing in enterprise solutions."
  }
}

The domain intelligence provides:

• category: Type of organization (business, education, government, etc.)
• name: Organization name
• industry: Industry classification
• country: Country code where the organization is based
• ticker: Stock ticker symbol (if publicly traded)
• employees: Approximate number of employees
• description: Brief description of the organization

For free email providers or when company data isn’t available, domain_insight may contain a simple string message instead of an object.

Implementation Strategies

Here are recommended ways to use qualification results in your applications:

Form Validation

For real-time form validation:

• Use valid_format to show immediate format errors
• Use did_you_mean to suggest corrections to users
• Use disposable to potentially block or flag disposable emails

Lead Scoring

For lead qualification and routing:

• Use free and disposable as negative scoring factors
• Use domain_insight.employees to identify enterprise leads
• Use domain_insight.industry to route leads to appropriate teams

Data Enrichment

For CRM and marketing automation:

• Add company data from domain_insight to contact records
• Segment contacts by industry, company size, and location
• Flag potentially low-quality leads based on email attributes

Example Scenario

Here’s an example of how to use the qualification data in a typical signup flow:

1. User submits form with email address
2. Your application calls Fuego’s API
3. If valid_format is false, show format error
4. If did_you_mean is provided, show a suggestion like “Did you mean to type [suggestion]?”
5. If disposable is true, either block submission or flag for review
6. If domain_insight contains company data, pre-fill company information in your form or CRM
7. Route the lead to the appropriate sales team based on company size and industry

Additional Considerations

• Cache Results: API responses are automatically cached for 30 days. Make use of this caching to optimize your API usage.
• Batch Processing: For large datasets, use our bulk qualification feature instead of making individual API calls.
• Webhook Integration: Consider setting up webhooks for real-time notifications when new qualification data is available.

For more detailed implementation guides, please refer to our API Documentation.