CUFinder API Documentation
APIs

Person Enrichment API

Names and companies provide starting points that sales teams need expanded into complete professional profiles. The Person Enrichment API transforms full names and company names into detailed contact records—including job title, email, phone, LinkedIn, and location—with 97% confidence scores. Built for developers creating lead completion and identity verification tools, this RESTful endpoint delivers comprehensive person data that power CRM enrichment, contact validation, and personalized outreach workflows across your sales stack.

CUFinder Official SDKs

POST

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

Required Attributes

  • x-api-key

    string

    Your API key.

  • full_name

    string

    Full name

  • company

    string

    Company name

Credit usage

10 for founded records

/v2/tep

Request
curl --location 'https://api.cufinder.io/v2/tep' \
     --header 'Content-Type: application/x-www-form-urlencoded' \
     --header 'x-api-key: api_key' \
     --data-urlencode 'full_name=iain mckenzie' \
     --data-urlencode 'company=stripe'
Response
{
    "status": 1,
    "data": {
        "confidence_level": 97,
        "query": "iain mckenzie at stripe",
        "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",
            "email": "[email protected]",
            "phone": null
        },
        "credit_count": 9761
    }
}

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

Person Enrichment 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.tep('iain mckenzie', 'stripe');
console.log(result);

Person Enrichment 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.tep('iain mckenzie', 'stripe')
print(result)

Person Enrichment 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.TEP("iain mckenzie", "stripe")
if err != nil {
  log.Fatal(err)
}
fmt.Println(result)

Person Enrichment 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.tep(full_name: 'iain mckenzie', company: 'stripe')
puts result

Person Enrichment 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.tep("iain mckenzie", "stripe").await?;
println!("{:?}", result);

Read More

LinkedIn Profile Email Finder

Official API docs for LinkedIn Email Finder endpoint. Extract verified work emails from LinkedIn with 94% accuracy. Lead generation guide.

Person Search

Official API docs for Person Search endpoint. Filter 1B+ profiles by name, company, location with 99% accuracy. Advanced prospecting guide.