CUFinder API Documentation

Local Business Search API

Local businesses represent untapped markets that B2C and service-based companies overlook in traditional B2B databases. The Local Business Search API queries neighborhood businesses by location and industry—returning phones, emails, ratings, and social profiles—with 95% confidence scores. Built for developers creating local marketing and service provider platforms, this RESTful endpoint delivers comprehensive small business data including NAICS codes and Google Maps integration that power geo-targeted campaigns, competitor analysis, and community outreach workflows across your sales stack.

POST

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

Required Attributes

  • x-api-key

    string

    Your API key.

  • name

    string (contains, ‘%john doe%’)

    Local business name

  • country

    string

    Local business country

Attributes

  • state

    string

    Local business state

  • city

    string

    Local business city

  • industry

    string

    Local business industry

  • page

    integer

    Page filter

Credit usage

5 for founded records

/v2/lbs

Request
 curl --location 'https://api.cufinder.io/v2/lbs' \
      --header 'Content-Type: application/json' \
      --header 'x-api-key: api_key' \
      --data '{
          "name": "sens",
          "country": "united states",
          "state": "california",
          "page": 1
      }'
Response
  {
    "status": 1,
    "data": {
        "confidence_level": 95,
        "query": {
            "country": "united states",
            "state": "california",
            "page": 1
        },
        "companies": [
            {
                "name": "Party Popper Balloons",
                "website": null,
                "industry": "balloon artist",
                "industry_details": {
                    "level_1": "Entertainer",
                    "level_2": "Entertainment and Recreation",
                    "naics_code": "711510",
                    "sic_code": "7929"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": null,
                    "rating": null,
                    "reviews_count": null
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [
                        "(415) 610-4787"
                    ],
                    "emails": [],
                    "phone_type": "FIXED_LINE_OR_MOBILE"
                }
            },
            {
                "name": "Easy Bookkeeping 123",
                "website": "https://www.easybookkeeping123.com/",
                "industry": "bookkeeping service",
                "industry_details": {
                    "level_1": "Bookkeeping Service",
                    "level_2": "Financial and Legal Services",
                    "naics_code": "541213",
                    "sic_code": "8721"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": null,
                    "rating": null,
                    "reviews_count": null
                },
                "social": {
                    "linkedin": "linkedin.com/company/123-bookkeeping",
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [
                        "(415) 570-8568"
                    ],
                    "emails": [
                        "[email protected]"
                    ],
                    "phone_type": "FIXED_LINE_OR_MOBILE"
                }
            },
            {
                "name": "All People Electric",
                "website": null,
                "industry": "electrician",
                "industry_details": {
                    "level_1": "Electrician",
                    "level_2": "Construction and Home Improvement",
                    "naics_code": "238210",
                    "sic_code": "1731"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": "ChIJMQl5OZ5ZhYARWe0rbOoE0EQ",
                    "rating": 4.7,
                    "reviews_count": 12
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [
                        "(925) 477-1877"
                    ],
                    "emails": [],
                    "phone_type": "FIXED_LINE_OR_MOBILE"
                }
            },
            {
                "name": "Kerex Engineering Inc.",
                "website": "http://kerexengineering.com/",
                "industry": "engineer",
                "industry_details": {
                    "level_1": "Engineering",
                    "level_2": "Industrial and Manufacturing",
                    "naics_code": "541330",
                    "sic_code": "8711"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": null,
                    "rating": null,
                    "reviews_count": null
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [],
                    "emails": [
                        "[email protected]"
                    ],
                    "phone_type": null
                }
            },
            {
                "name": "Delta Renovation",
                "website": "http://www.delta-renovation.com/",
                "industry": "kitchen remodels",
                "industry_details": {
                    "level_1": "Kitchen Remodeler",
                    "level_2": "Construction and Home Improvement",
                    "naics_code": "236118",
                    "sic_code": "1521"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": null,
                    "rating": null,
                    "reviews_count": null
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [
                        "(925) 239-0055"
                    ],
                    "emails": [
                        "[email protected]"
                    ],
                    "phone_type": "FIXED_LINE_OR_MOBILE"
                }
            },
            {
                "name": "Prospera Mental Health & Wellness",
                "website": "http://prosperamhw.com/",
                "industry": "mental health service",
                "industry_details": {
                    "level_1": "Mental health clinic",
                    "level_2": "Health and Medical Services",
                    "naics_code": "621330",
                    "sic_code": "8063"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": "ChIJlROjcreBhYARo3QkWH9bPa8",
                    "rating": 5,
                    "reviews_count": 27
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [
                        "(415) 684-8146"
                    ],
                    "emails": [
                        "[email protected]"
                    ],
                    "phone_type": "FIXED_LINE_OR_MOBILE"
                }
            },
            {
                "name": "Briones Peak",
                "website": null,
                "industry": "mountain peak",
                "industry_details": {
                    "level_1": "Landmark",
                    "level_2": "Real Estate and Property Management",
                    "naics_code": "713990",
                    "sic_code": "7999"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": "California 94553"
                },
                "geo_location": {
                    "google_maps_id": null,
                    "rating": null,
                    "reviews_count": null
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [],
                    "emails": [],
                    "phone_type": null
                }
            },
            {
                "name": "Jackson PR Enterprises",
                "website": "https://www.jacksonprenterprises.net/",
                "industry": "notary public",
                "industry_details": {
                    "level_1": "Notary Public",
                    "level_2": "Financial and Legal Services",
                    "naics_code": "541120",
                    "sic_code": "6541"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": null,
                    "rating": null,
                    "reviews_count": null
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [
                        "(707) 208-5388"
                    ],
                    "emails": [],
                    "phone_type": "FIXED_LINE_OR_MOBILE"
                }
            },
            {
                "name": "All American Paints",
                "website": null,
                "industry": "painter",
                "industry_details": {
                    "level_1": "Painter",
                    "level_2": "Arts and Crafts",
                    "naics_code": "238320",
                    "sic_code": "1721"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": null,
                    "rating": null,
                    "reviews_count": null
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [
                        "(925) 705-1695"
                    ],
                    "emails": [],
                    "phone_type": "FIXED_LINE_OR_MOBILE"
                }
            },
            {
                "name": "Lamorinda Gopher, LLC",
                "website": "http://lamorindagopher.com/",
                "industry": "pest control service",
                "industry_details": {
                    "level_1": "Pest Control Service",
                    "level_2": "Agricultural and Environmental Services",
                    "naics_code": "561710",
                    "sic_code": "7342"
                },
                "main_location": {
                    "country": "united states",
                    "state": "california",
                    "city": "acalanes ridge",
                    "address": null
                },
                "geo_location": {
                    "google_maps_id": "ChIJe5DtBcF9hYARQNoeUoOJskc",
                    "rating": 5,
                    "reviews_count": 6
                },
                "social": {
                    "linkedin": null,
                    "twitter": null,
                    "facebook": null,
                    "instagram": null,
                    "youtube": null
                },
                "connections": {
                    "phones": [
                        "(925) 257-0023"
                    ],
                    "emails": [],
                    "phone_type": "FIXED_LINE_OR_MOBILE"
                }
            }
        ],
        "credit_count": 9978
      }
  }

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

Local Business 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.lbs({
  country: 'united states',
  state: 'california',
  page: 1
});
console.log(result);

Local Business 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.lbs(
  country='united states',
  state='california',
  page=1
)
print(result)

Local Business 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.LBS(cufinder.LbsParams{
  Country: "united states",
  State:   "california",
  Page:    1,
})
if err != nil {
  log.Fatal(err)
}
fmt.Println(result)

Local Business 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.lbs(
  country: 'united states',
  state: 'california',
  page: 1
)
puts result

Local Business 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::LbsParams;

let result = sdk.lbs(LbsParams {
  country: Some("united states".to_string()),
  state: Some("california".to_string()),
  page: Some(1),
  ..Default::default()
}).await?;
println!("{:?}", result);