Research Company Location

Find headquarters location information for companies by analyzing company websites, job postings, and public records.


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-location
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": "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

Was this page helpful?