Research Company Location
Find headquarters location information for companies by analyzing company websites, job postings, and public records.
This tool is part of our beta Tools API. Contact sales to request increased limits (available to select partners).
POST/v1/tools/research-company-location
Endpoint
This endpoint discovers headquarters location data about a company, and sometimes additional office locations when available.
Required parameters
- Name
company_name
- Type
- string
- Description
Name of the company to research.
- Name
company_url
- Type
- string
- Description
The company's website URL.
Optional parameters
- Name
output_schema
- Type
- object
- Description
Define the structure of the output you want to receive.
Request
POST
/v1/tools/research-company-locationcurl -X POST https://api.utopianlabs.ai/v1/tools/research-company-location \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"company_name": "GitLab",
"company_url": "https://gitlab.com"
}'
Response
{
"output": "GitLab is incorporated in Delaware, USA with a virtual office address in San Francisco for legal purposes. As a fully remote company, they have no physical headquarters location."
}
Structured Output Example
Get headquarters location details in a structured format.
Request with schema
curl -X POST https://api.utopianlabs.ai/v1/tools/research-company-location \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"company_name": "Shopify",
"company_url": "https://shopify.com",
"output_schema": {
"headquarters": {
"city": "string",
"state_province": "string",
"country": "string",
"address": "string"
}
}
}'
Structured response
{
"output": {
"headquarters": {
"city": "Ottawa",
"state_province": "Ontario",
"country": "Canada",
"address": "150 Elgin Street, Ottawa, ON K2P 1L4"
}
}
}
Limitations
- Focuses primarily on headquarters location
- Additional offices may not be comprehensive
- Virtual office addresses may be used
- Some locations may be confidential
- Legal vs operational headquarters may differ