CUFinder API Documentation

Company Phone Finder API

Phone numbers create direct lines to prospects that email alone can't match. The Company Phone Finder API returns up to two verified business phone numbers from company names, domains, or LinkedIn URLs with 93% confidence scores. Built for developers building CRM enrichment and customer support tools, this RESTful endpoint delivers validated contact numbers that power outbound calling systems, data completion workflows, and multi-channel outreach campaigns across your sales stack.

POST

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

Required Attributes

  • x-api-key

    string

    Your API key.

  • company_name

    string

    Company name or Company domain or Company LinkedIn URL

Credit usage

2 for founded records

/v2/ntp

Request
curl --location 'https://api.cufinder.io/v2/ntp' \
     --header 'Content-Type: application/x-www-form-urlencoded' \
     --header 'x-api-key: api_key' \
     --data-urlencode 'company_name=apple'
Response
{
    "status": 1,
    "data": {
        "confidence_level": 93,
        "query": "apple",
        "phones": [
            "+800046046",
            "+800554533",
            "+900150503"
        ],
        "credit_count": 9825
    }
}

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

Company Phone Finder 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.ntp('apple');
console.log(result);

Company Phone Finder 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.ntp('apple')
print(result)

Company Phone Finder 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.NTP("apple")
if err != nil {
  log.Fatal(err)
}
fmt.Println(result)

Company Phone Finder 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.ntp(company_name: 'apple')
puts result

Company Phone Finder 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.ntp("apple").await?;
println!("{:?}", result);