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 2 credits per request.

Attributes

string

required

Company domain, name, or LinkedIn URL.

Response

{
    "success": true,
    "data": {
        "locations": [
            {
                "country": "united states",
                "state": "washington",
                "city": "redmond",
                "address": "1 Microsoft Way",
                "postal_code": "98052"
            },
            {
                "country": "australia",
                "state": "nsw",
                "city": "north sydney",
                "address": "1 Denison Street",
                "postal_code": "2060"
            },
            {
                "country": "canada",
                "state": "ontario",
                "city": "mississauga",
                "address": "1950 Meadowvale Blvd",
                "postal_code": "L5N 8L9"
            },
            {
                "country": "france",
                "state": "île-de-france",
                "city": "issy-les-moulineaux",
                "address": "39, Quai du Président Roosevelt",
                "postal_code": "92130"
            },
            {
                "country": "germany",
                "state": null,
                "city": "münchen",
                "address": "Walter-Gropius-Straße 5",
                "postal_code": "80807"
            },
            {
                "country": "japan",
                "state": "tokyo",
                "city": "minato-ku",
                "address": "2-16-3 Konan",
                "postal_code": "108-0075"
            },
            {
                "country": "united kingdom",
                "state": "berkshire",
                "city": "reading",
                "address": "Thames Valley Park Drive",
                "postal_code": "RG6 1WG"
            },
            {
                "country": "denmark",
                "state": null,
                "city": null,
                "address": "Kanalvej 7",
                "postal_code": "2800 Kongens Lyngby"
            },
            {
                "country": "belgium",
                "state": "flemish region",
                "city": "zaventem",
                "address": "Luchthavenlaan 1k",
                "postal_code": "1930"
            },
            {
                "country": "finland",
                "state": null,
                "city": "espoo",
                "address": "Keilalahdentie 2-4",
                "postal_code": "02150"
            },
            {
                "country": "italy",
                "state": "lombardy",
                "city": "milan",
                "address": "Viale Pasubio, 21",
                "postal_code": "20154"
            },
            {
                "country": "south korea",
                "state": "seoul",
                "city": "jongno-gu",
                "address": "50, Jongro 1-gil",
                "postal_code": null
            },
            {
                "country": "netherlands",
                "state": "north holland",
                "city": "schiphol",
                "address": "Evert van de Beekstraat 354",
                "postal_code": "1118 CZ"
            },
            {
                "country": "norway",
                "state": null,
                "city": "oslo",
                "address": "Dronning Eufemia gate 71",
                "postal_code": "0194"
            },
            {
                "country": "spain",
                "state": null,
                "city": "pozuelo de alarcón",
                "address": "Paseo del Club Deportivo, 1",
                "postal_code": "28223"
            },
            {
                "country": "sweden",
                "state": null,
                "city": "stockholm",
                "address": "Regeringsgatan 25",
                "postal_code": "111 53"
            },
            {
                "country": "switzerland",
                "state": null,
                "city": "zürich",
                "address": "8058 Zürich-Flughafen",
                "postal_code": null
            },
            {
                "country": "brazil",
                "state": null,
                "city": "sao paulo",
                "address": "Av. President Juscelino Kubitscheck, 1909",
                "postal_code": "04551-065"
            },
            {
                "country": "china",
                "state": null,
                "city": "中国",
                "address": "海淀区，丹棱街5号",
                "postal_code": "100080"
            },
            {
                "country": "india",
                "state": null,
                "city": "gurgaon",
                "address": "DLF Building No.5 (Epitome), Cyber City, DLF Phase III",
                "postal_code": "122002"
            },
            {
                "country": "mexico",
                "state": null,
                "city": "del álvaro obregón",
                "address": "Av. Vasco de Quiroga 3200",
                "postal_code": "01210"
            },
            {
                "country": "russia",
                "state": null,
                "city": "москва",
                "address": "Ул. Крылатская, 17",
                "postal_code": "121614"
            },
            {
                "country": "south africa",
                "state": "gauteng",
                "city": "johannesburg",
                "address": "3012 William Nicol Drive",
                "postal_code": "2191"
            },
            {
                "country": "turkey",
                "state": null,
                "city": "i̇stanbul",
                "address": "Aydın Sokak No:7",
                "postal_code": "34340"
            },
            {
                "country": "austria",
                "state": null,
                "city": "vienna",
                "address": "Am Europlatz 3",
                "postal_code": "1120"
            },
            {
                "country": "hong kong",
                "state": null,
                "city": "hong kong",
                "address": "100 Cyberport Road",
                "postal_code": null
            },
            {
                "country": "ireland",
                "state": "dublin",
                "city": "leopardstown",
                "address": "One Microsoft Place",
                "postal_code": "18 D18"
            },
            {
                "country": "israel",
                "state": null,
                "city": "רעננה",
                "address": "רחוב הפנינה 2",
                "postal_code": "43107"
            },
            {
                "country": "new zealand",
                "state": null,
                "city": "auckland",
                "address": "22 Viaduct Harbour Avenue",
                "postal_code": null
            },
            {
                "country": "poland",
                "state": null,
                "city": "warszawa",
                "address": "Al. Jerozolimskie 195a",
                "postal_code": "02-222"
            },
            {
                "country": "portugal",
                "state": null,
                "city": "lisboa",
                "address": "Rua do Fogo de Santelmo, Lote 2.07.02",
                "postal_code": "1990 – 110"
            },
            {
                "country": "saudi arabia",
                "state": null,
                "city": "riyadh",
                "address": "The Business Gate, Building A2 Airport Road, Cordobah",
                "postal_code": "11552"
            },
            {
                "country": "singapore",
                "state": null,
                "city": "singapore",
                "address": "182 Cecil Street",
                "postal_code": "069547"
            },
            {
                "country": "slovakia",
                "state": null,
                "city": "bratislava",
                "address": "Pradiareň 1900",
                "postal_code": "821 08"
            },
            {
                "country": "taiwan",
                "state": "taipei city",
                "city": "xinyi district",
                "address": "Zhongxiao East Road Section 5 No. 68",
                "postal_code": null
            },
            {
                "country": "united arab emirates",
                "state": null,
                "city": "dubai",
                "address": "Sheikh Zayed Road",
                "postal_code": "52244"
            },
            {
                "country": "argentina",
                "state": null,
                "city": "buenos aires",
                "address": "1106 Federal Capital",
                "postal_code": null
            },
            {
                "country": "chile",
                "state": null,
                "city": "santiago",
                "address": "Av. Vitacura 6844",
                "postal_code": null
            },
            {
                "country": "colombia",
                "state": null,
                "city": "bogota",
                "address": "Calle 92 # 11 – 51",
                "postal_code": null
            },
            {
                "country": "egypt",
                "state": null,
                "city": "cairo",
                "address": "Kilo 28, Cairo/Alex Desert Road",
                "postal_code": null
            },
            {
                "country": "indonesia",
                "state": null,
                "city": "jakarta",
                "address": "Jl. Jend. Sudirman Kav. 52-53",
                "postal_code": "12190"
            },
            {
                "country": "malaysia",
                "state": null,
                "city": "kuala lumpur",
                "address": "No. 211, Jalan Tun Sambanthan",
                "postal_code": "50470"
            },
            {
                "country": "philippines",
                "state": null,
                "city": "makati city",
                "address": "Ayala Avenue cor Edsa, Brgy. San Lorenzo,",
                "postal_code": "1223"
            },
            {
                "country": "romania",
                "state": null,
                "city": "bucurești",
                "address": "Bulevardul Iuliu Maniu nr. 6P",
                "postal_code": "061103"
            },
            {
                "country": "thailand",
                "state": null,
                "city": "เขตปทุมวัน กรุงเทพฯ",
                "address": "87/2 ถนนวิทยุ แขวงลุมพินี",
                "postal_code": "10330"
            }
        ]
    },
    "meta": {
        "confidence": 97,
        "query": {
            "query": "microsoft"
        },
        "credits": {
            "charged": 2,
            "remaining": 9862
        }
    }
}

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