Company Locations API Documentation

Office addresses provide geographic context that field sales teams need for territory planning and in-person meetings. The Company Locations API returns verified business addresses including country, state, city, postal code, and street details from company queries with 95% confidence scores. Built for developers creating field sales and logistics tools, this RESTful endpoint delivers complete location data that power route planning, regional targeting, and local market analysis workflows across your sales stack.

CUFinder Official SDKs

POST

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

Required Attributes

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

Credit usage

2 for founded records

/v2/clo

Request

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

Response

 {
      "status": 1,
      "data": {
          "confidence_level": 95,
          "query": "apple",
          "locations": [
              {
                  "country": "united states",
                  "state": "california",
                  "city": "cupertino",
                  "postal_code": "95014",
                  "line1": "1 Apple Park Way",
                  "line2": null,
                  "latitude": null,
                  "longitude": null
              }
          ],
          "credit_count": 9996
      }
 }

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 Locations 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.clo('apple');
console.log(result);

Company Locations 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.clo('apple')
print(result)

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

Company Locations 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.clo(query: 'apple')
puts result

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