Company Locations API

curl --request POST \
  --url https://api.cufinder.io/v3/companies/locations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": "<string>"
}
'

import requests

url = "https://api.cufinder.io/v3/companies/locations"

payload = { "query": "<string>" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: '<string>'})
};

fetch('https://api.cufinder.io/v3/companies/locations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cufinder.io/v3/companies/locations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cufinder.io/v3/companies/locations"

	payload := strings.NewReader("{\n  \"query\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cufinder.io/v3/companies/locations")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cufinder.io/v3/companies/locations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Company APIs

Company Locations API

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.

POST

companies

locations

curl --request POST \
  --url https://api.cufinder.io/v3/companies/locations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": "<string>"
}
'

import requests

url = "https://api.cufinder.io/v3/companies/locations"

payload = { "query": "<string>" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: '<string>'})
};

fetch('https://api.cufinder.io/v3/companies/locations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cufinder.io/v3/companies/locations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cufinder.io/v3/companies/locations"

	payload := strings.NewReader("{\n  \"query\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.cufinder.io/v3/companies/locations")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cufinder.io/v3/companies/locations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Common Use Cases

Where a company operates shapes territory assignments, field visits, and compliance checks.

Territory Planning: Assigning accounts to reps by office location.
Field Sales: Routing on-site visits and events around company sites.
Market Research: Mapping a company’s geographic footprint.
Data Enrichment: Adding office and HQ locations to CRM records.
Compliance: Checking where a company operates for regional rules.

Credit usage is 1 credit per request.

Attributes

string

required

Company domain, name, or LinkedIn URL.

Response

{
    "success": true,
    "data": {
        "locations": {
            "hq_location": {
                "country": "united states",
                "state": "california",
                "city": "san francisco",
                "address": "415 mission st,san francisco, california 94105, us",
                "postal_code": "94105",
                "latitude": null,
                "longitude": null
            },
            "other_locations": [
                {
                    "country": "united states",
                    "state": "california",
                    "city": "san francisco",
                    "address": "415 Mission St",
                    "postal_code": "94105",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "switzerland",
                    "state": "switzerland",
                    "city": "staines",
                    "address": "1 Market",
                    "postal_code": null,
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "united states",
                    "state": "singapore",
                    "city": "singapore",
                    "address": "1 Market",
                    "postal_code": "038989",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "japan",
                    "state": "tokyo",
                    "city": "chiyoda-ku",
                    "address": "1-1-3 Marunouchi",
                    "postal_code": "100-0005",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "germany",
                    "state": null,
                    "city": "munich",
                    "address": "Erika-Mann.Straße 63",
                    "postal_code": "80636",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "united kingdom",
                    "state": "england",
                    "city": "london",
                    "address": "9 Bishopsgate",
                    "postal_code": "EC2N 3",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "australia",
                    "state": "vic",
                    "city": "melbourne",
                    "address": "55 Collins St",
                    "postal_code": "3000",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "australia",
                    "state": "nsw",
                    "city": "sydney",
                    "address": "201 Sussex St",
                    "postal_code": "2000",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "france",
                    "state": "idf",
                    "city": "paris",
                    "address": "3 Avenue Octave Greard",
                    "postal_code": "75007",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "united states",
                    "state": "illinois",
                    "city": "chicago",
                    "address": "111 W Illinois St",
                    "postal_code": "60654",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "united states",
                    "state": "texas",
                    "city": "dallas",
                    "address": "14902 Preston Rd",
                    "postal_code": "75254",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "united states",
                    "state": "georgia",
                    "city": "atlanta",
                    "address": "950 E Paces Ferry Rd NE",
                    "postal_code": "30326",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "united states",
                    "state": "massachusetts",
                    "city": "burlington",
                    "address": "5 Wall St",
                    "postal_code": "01803",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "italy",
                    "state": "lomb.",
                    "city": "milan",
                    "address": "Via Niccolo Copernico, 38",
                    "postal_code": "20125",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "germany",
                    "state": "be",
                    "city": "berlin",
                    "address": "Kurfurstendamm 194",
                    "postal_code": "10707",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "spain",
                    "state": "community of madrid",
                    "city": "madrid",
                    "address": "Paseo de la Castellana, 79",
                    "postal_code": "28046",
                    "latitude": null,
                    "longitude": null
                },
                {
                    "country": "israel",
                    "state": "tel aviv",
                    "city": "tel aviv-yafo",
                    "address": "Derekh Menahem Begin 154",
                    "postal_code": "60000",
                    "latitude": null,
                    "longitude": null
                }
            ]
        },
        "company": {
            "name": "salesforce",
            "domain": "salesforce.com",
            "industry": {
                "name": "software development",
                "sic_code": null,
                "naics_code": null
            },
            "type": "public company",
            "size": {
                "employee_range": "10001+",
                "employee_count": 90263
            },
            "followers_count": 6846449,
            "location": {
                "country": "united states",
                "country_code": "US",
                "state": "california",
                "city": "san francisco",
                "address": "415 mission st,san francisco, california 94105, us",
                "postal_code": "94105",
                "latitude": null,
                "longitude": null
            },
            "social": {
                "linkedin": "linkedin.com/company/salesforce",
                "facebook": "facebook.com/salesforce",
                "instagram": "instagram.com/salesforcejobs/",
                "twitter_x": "twitter.com/asksalesforce",
                "youtube": "youtube.com/salesforce",
                "tiktok": "https://tiktok.com/@salesforce.mike"
            }
        }
    },
    "meta": {
        "confidence": 97,
        "query": {
            "query": "salesforce.com"
        },
        "credits": {
            "charged": 1,
            "remaining": 9372
        }
    }
}

Company Enrichment

Enrich a company with full firmographics.

Company Subsidiaries Finder

Map a company’s subsidiaries.

Local Business Search

Find local businesses via Google Maps.

Address Normalizer

Standardize and validate postal addresses.

Getting started

Documentations

Company Locations API

Common Use Cases

Attributes

Response

Company Enrichment

Company Subsidiaries Finder

Local Business Search

Address Normalizer

​Common Use Cases

​Attributes

​Response

​Related APIs

Company Enrichment

Company Subsidiaries Finder

Local Business Search

Address Normalizer

Common Use Cases

Attributes

Response

Related APIs