Company Search API Documentation

Advanced filtering transforms generic databases into laser-targeted prospect lists that sales teams actually convert. The Company Search API queries CUFinder's 85M+ company profiles using multiple parameters—including location, industry, employee size, funding, and founding year—returning filtered business data with 96% confidence scores. Built for developers creating prospecting tools and market intelligence platforms, this RESTful endpoint delivers granular company matches that power account-based marketing, lead generation, and competitive analysis workflows across your sales stack.

CUFinder Official SDKs

POST

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

Required Attributes

x-api-key
string
Your API key.
country
string
Company country

Attributes

state
string
Company state
city
string
Company city
followers_count_min
integer
Company minimum followers count
followers_count_max
integer
Company maximum followers count
name
string (contains, '%stripe%')
Company name
industry
string
Company industry
employee_size
['0-1', '1 employee', '1,001-5,000', '10,001+', '11-50', '2-10', '201-500', '5,001-10,000', '501-1,000', '501-1000', '51-200']
Company employees size range
founded_before_year
integer
Company founded before year
founded_after_year
integer
Company founded after year
funding_amount_min
integer
Company minimum funding amount
funding_amount_max
integer
Company maximum funding amount
products_services
array of string
Company services.
is_school
boolean
Check whether company is a school
annual_revenue_min
integer (Million Dollar)
Company minimum annual revenue
annual_revenue_max
integer (Million Dollar)
Company maximum annual revenue
page
integer
Page filter

Credit usage

3 for founded records

/v2/cse

Request

curl --location 'https://api.cufinder.io/v2/cse' \
      --header 'Content-Type: application/json' \
      --header 'x-api-key: api_key' \
      --data '{
          "name": "cufinder",
          "country": "germany",
          "state": "hamburg",
          "city": "hamburg",
          "industry": "software development",
          "employee_size": "51-200",
          "founded_after_year": 2020,
          "founded_before_year": 2025,
          "funding_amount_min": 1000000,
          "funding_amount_max": 10000000,
          "products_services": ["b2b"],
          "is_school": false,
          "page": 1
      }'

Response

{
    "status": 1,
    "data": {
        "confidence_level": 96,
        "query": {
            "name": "cufinder",
            "country": "germany",
            "state": "hamburg",
            "city": "hamburg",
            "industry": "software development",
            "employee_size": "51-200",
            "founded_after_year": 2020,
            "founded_before_year": 2025,
            "funding_amount_min": 1000000,
            "funding_amount_max": 10000000,
            "products_services": [
                "b2b"
            ],
            "is_school": false,
            "page": 1
        },
        "companies": [
            {
                "name": "cufinder",
                "website": "https://cufinder.io",
                "domain": "cufinder.io",
                "employees": {
                    "range": "51-200"
                },
                "industry": "software development",
                "overview": "unleash the full potential of your b2b, b2c, and even local business with cufinder - the all-in-one platform powered by ai for lead generation and real-time data enrichment.cufinder equips you with a massive global database of over +262m companies and +419m contacts associated with +5k industries, boasting an impressive 98% data accuracy. its suite of powerful engines allows you to discover targeted leads, decision-makers, managers, and any info you can think of based on your specific needs!enrich your sales pipeline with 27 data enrichment services, user-friendly tools, and seamless crm integrations. manage your sales team effectively with built-in team management features, and leverage the convenience of chrome extension functionalities along with fair prices and customizable plans to fit any budget and empower your sales success across all business categories.",
                "type": "privately held",
                "main_location": {
                    "country": "germany",
                    "state": "hamburg",
                    "city": "hamburg",
                    "address": "lentersweg 36,hamburg, 22339, de"
                },
                "social": {
                    "facebook": null,
                    "linkedin": "linkedin.com/company/cufinder",
                    "twitter": null
                }
            }
        ],
        "credit_count": 9993
    }
}

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 Search 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.cse({
  name: 'cufinder',
  country: 'germany',
  state: 'hamburg',
  city: 'hamburg'
});
console.log(result);

Company Search 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.cse(
  name='cufinder',
  country='germany',
  state='hamburg',
  city='hamburg'
)
print(result)

Company Search 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.CSE(cufinder.CseParams{
  Name:    "cufinder",
  Country: "germany",
  State:   "hamburg",
  City:    "hamburg",
})
if err != nil {
  log.Fatal(err)
}
fmt.Println(result)

Company Search 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.cse(
  name: 'cufinder',
  country: 'germany',
  state: 'hamburg',
  city: 'hamburg'
)
puts result

Company Search 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(())
}

use cufinder_rust::CseParams;

let result = sdk.cse(CseParams {
  name: Some("cufinder".to_string()),
  country: Some("germany".to_string()),
  state: Some("hamburg".to_string()),
  city: Some("hamburg".to_string()),
  ..Default::default()
}).await?;
println!("{:?}", result);