CUFinder API Documentation

Reverse Email Lookup API

Email addresses hide complete professional profiles that marketing and sales teams need for personalization. The Reverse Email Lookup API transforms email addresses into detailed person and company data—including full name, job title, LinkedIn, employer, and location—with 98% confidence scores. Built for developers creating identity resolution and lead validation tools, this RESTful endpoint delivers comprehensive contact profiles that power email verification, account enrichment, and prospect intelligence workflows across your sales stack.

POST

https://api.cufinder.io/v2/rel

Required Attributes

  • x-api-key

    string

    Your API key.

  • email

    string

    Email address

Credit usage

4 for founded records

/v2/rel

Request
curl --location 'https://api.cufinder.io/v2/rel' \
     --header 'Content-Type: application/x-www-form-urlencoded' \
     --header 'x-api-key: api_key' \
     --data-urlencode '[email protected]'
Response
{
    "status": 1,
    "data": {
        "confidence_level": 98,
        "query": "[email protected]",
        "person": {
            "first_name": "iain",
            "last_name": "mckenzie",
            "full_name": "iain mckenzie",
            "linkedin_url": "linkedin.com/in/iain-mckenzie",
            "summary": null,
            "followers_count": 0,
            "facebook": null,
            "twitter": null,
            "avatar": "media.cufinder.io/person_profile/iain-mckenzie",
            "country": "canada",
            "state": null,
            "city": null,
            "job_title": "engineering",
            "job_title_categories": [],
            "company_name": "stripe",
            "company_linkedin": "linkedin.com/company/stripe",
            "company_website": "https://stripe.com",
            "company_size": "1,001-5,000",
            "company_industry": "technology, information and internet",
            "company_facebook": "facebook.com/stripepayments",
            "company_twitter": "twitter.com/stripe",
            "company_country": "united states",
            "company_state": "california",
            "company_city": "south san francisco"
        },
        "credit_count": 9781
    }
}

Status Codes

  • 200

    indicates a successful response.

  • 400

    indicates a not enough credits.

  • 401

    indicates an invalid API key.

  • 404

    indicates a not found results (Our algorithm can't find a data for your query).

  • 422

    indicates an error in sending data.

  • 500

    indicates a server error — you won't be seeing these

Reverse Email Lookup API typescript SDK

Request
import { Cufinder } from '@cufinder/cufinder-ts';

// Initialize the client
const client = new Cufinder('your-api-key-here');

// Initialize with more options
const client = new Cufinder('your-api-key-here', { timeout: 60000 });

const result = await client.rel('[email protected]');
console.log(result);

Reverse Email Lookup API python SDK

Request
from cufinder import Cufinder

# Initialize the client
client = Cufinder('your-api-key-here')

# Initialize with more options
client = Cufinder('your-api-key-here', timeout=60)

result = client.rel('[email protected]')
print(result)

Reverse Email Lookup API go SDK

Request
package main

import (
    "fmt"
    "log"
    
    "github.com/cufinder/cufinder-go"
)

func main() {
    // Initialize the client
    sdk := cufinder.NewSDK("your-api-key-here")
    
    // Initialize with more options
    sdk := cufinder.NewSDKWithConfig(cufinder.ClientConfig{
        APIKey:     "your-api-key-here",
        BaseURL:    "https://api.cufinder.io/v2",
        Timeout:    60 * time.Second,
        MaxRetries: 3,
    })
}

result, err := sdk.REL("[email protected]")
if err != nil {
    log.Fatal(err)
}
fmt.Println(result)

Reverse Email Lookup API ruby SDK

Request
require 'cufinder_ruby'

# Initialize the client
client = Cufinder::Client.new(api_key: 'your-api-key-here')

# Initialize with more options
client = Cufinder::Client.new(
  api_key: 'your-api-key-here',
  timeout: 60,
  max_retries: 3
)

result = client.rel(email: '[email protected]')
puts result

Reverse Email Lookup API rust SDK

Request
use cufinder_rust::CufinderSDK;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize the client
    let sdk = CufinderSDK::new("your-api-key-here".to_string())?;
    
    // Initialize with more options
    let sdk = CufinderSDK::with_config(ClientConfig {
        api_key: "your-api-key-here".to_string(),
        base_url: "https://api.cufinder.io/v2".to_string(),
        timeout: Duration::from_secs(60),
        max_retries: 3,
    })?;
    
    Ok(())
}

let result = sdk.rel("[email protected]").await?;
println!("{:?}", result);