Company Employee Count API Documentation

Employee distribution data reveals organizational scale and geographic presence that sales teams need for territory planning. The Company Employee Count API returns detailed headcount breakdowns by country from company names or domains with 98% confidence scores. Built for developers creating workforce intelligence and market sizing tools, this RESTful endpoint delivers granular employee location data that power territory assignment, market entry strategies, and account prioritization workflows across your sales stack.

CUFinder Official SDKs

POST

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

Required Attributes

x-api-key
string
Your API key.
query
string
Company name or Company domain or Company LinkedIn URL

Credit usage

1 for founded records

/v2/cec

Request

curl --location 'https://beta.core.cufinder.io/api/v2/cec' \
     --header 'Content-Type: application/x-www-form-urlencoded' \
     --header 'x-api-key: api_key' \
     --data-urlencode 'query=cufinder'

Response

{
    "status": 1,
    "data": {
      "confidence_level": 98,
      "query": "cufinder",
      "countries": {
        "germany": 9,
        "iran": 9,
        "turkey": 3,
        "united states": 2,
        "united arab emirates": 1,
        "null": 1,
        "netherlands": 1
      },
      "credit_count": 9999
    }
}

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 Employee Count 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.cec('cufinder');
console.log(result);

Company Employee Count 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.cec('cufinder')
print(result)

Company Employee Count 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.CEC("cufinder")
if err != nil {
  log.Fatal(err)
}
fmt.Println(result)

Company Employee Count 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.cec(query: 'cufinder')
puts result

Company Employee Count 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.cec("cufinder").await?;
println!("{:?}", result);