Skip to main content
POST
/
v2
/
cse
Company Search API
curl --request POST \
  --url https://api.cufinder.io/v2/cse \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "country": "<string>",
  "state": "<string>",
  "city": "<string>",
  "followers_count_min": 123,
  "followers_count_max": 123,
  "name": {},
  "industry": "<string>",
  "employee_size": {},
  "founded_before_year": 123,
  "founded_after_year": 123,
  "funding_amount_min": 123,
  "funding_amount_max": 123,
  "products_services": {},
  "is_school": true,
  "annual_revenue_min": 123,
  "annual_revenue_max": 123,
  "page": 123
}
'

​
Common Use Cases

The right combination of filters turns a blank page into a ready-to-work prospect list.
  • Lead Generation: Building targeted company lists from combined filters.
  • Account-Based Marketing: Finding every account that fits an ideal customer profile.
  • Market Research: Exploring a segment by industry, size, location, and more.
  • Territory Building: Pulling companies for a specific region or vertical.
  • List Building: Generating fresh prospect lists on demand.
Credit usage is 3 per record found.

​
Attributes

​
country
string
required
Company country
​
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
string ('0-1', '1 employee', '2-10', '11-50', '51-200', '201-500', '501-1000', '501-1,000', '1,001-5,000', '5,001-10,000', '10,001+')
Company employee 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[string]
Company services
​
is_school
boolean
Whether the company is a school
​
annual_revenue_min
integer
Company minimum annual revenue (Million USD)
​
annual_revenue_max
integer
Company maximum annual revenue (Million USD)
​
page
integer
Page filter

​
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
    }
}

​
Company Search API Typescript SDK

 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

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

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

 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

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);

Company Lookalikes Finder

Discover companies similar to a target.

B2B Customers Finder

Identify a company’s likely B2B customers.

Person Search

Search 1B+ profiles with combined filters.

Company Enrichment

Enrich a company with full firmographics.