Skip to main content

Company Object Model

Overview​

Key: company

The company Object Model within the profileAPI system is for companies and organizations. The following are the fields that are included in company.

About​

Id​

  • Key: id
  • Data Type: uuid
  • Description: A universally unique identifier (UUID) compliant with RFC 4122, used to uniquely identify a person. Presented without hyphens.
  • Example: "9e6a55b258ef11edb8780242ac120002"

Name​

  • Key: name
  • Data Type: string
  • Premium: false
  • Description: The company's name, including any suffixes such as "Inc." if applicable.
  • Example: Acme Inc.

Clean Name​

  • Key: cleanName
  • Data Type: string
  • Premium: false
  • Description: The clean company name, excluding any suffixes such as "Inc.".
  • Example: Acme

Logo Url​

  • Key: logoUrl
  • Data Type: url
  • Premium: false
  • Description: A link to the company's logo image, following the RFC 3986 URL formatting guidelines.
  • Example: https://d1hbpr09pwz0sk.cloudfront.net/logo_url/606f524f

Headcount​

  • Key: headcount
  • Data Type: number
  • Premium: false
  • Description: The total number of employees working at the company.
  • Example: 22

Website​

  • Key: website
  • Data Type: url
  • Premium: false
  • Description: A link to the company's website, formatted according to RFC 3986 guidelines.
  • Example: https://acme.com

Angellist URL​

  • Key: angellistUrl
  • Data Type: url
  • Premium: false
  • Description: URL to an AngelList profile.
  • Format: https://angel.co/[handle]
  • Example: https://angel.co/acme

Crunchbase URL​

  • Key: crunchbaseUrl
  • Data Type: url
  • Premium: false
  • Description: URL to a Crunchbase profile.
  • Format: https://www.crunchbase.com/organization/[handle]
  • Example: https://www.crunchbase.com/organization/acme

Facebook URL​

  • Key: facebookUrl
  • Data Type: url
  • Premium: false
  • Description: URL to a Facebook profile.
  • Format: https://facebook.com/[username]
  • Example: https://facebook.com/acme

Github URL​

  • Key: githubUrl
  • Data Type: url
  • Premium: false
  • Description: URL to a GitHub profile.
  • Format: https://github.com/[username]
  • Example: https://github.com/acme

LinkedIn URL​

  • Key: linkedInUrl
  • Data Type: url
  • Premium: false
  • Description: URL to a LinkedIn profile.
  • Format: https://linkedin.com/company/[handle]
  • Example: https://linkedin.com/company/acme

X URL​

  • Key: xUrl
  • Data Type: url
  • Premium: false
  • Description: URL to an X (Twitter) profile.
  • Format: https://twitter.com/[username]
  • Example: https://twitter.com/acme

Youtube URL​

  • Key: youtubeUrl
  • Data Type: url
  • Premium: false
  • Description: URL to a YouTube channel.
  • Format: https://youtube.com/user/[username]
  • Example: https://youtube.com/user/acme

Industries​

Industry​

  • Key: industry
  • Data Type: string
  • Premium: false
  • Description: Our AI classifies a company into a specific industry based on reading the company website and other public data. This differs from self-reported data sets, which may require additional cleaning and transformation.
  • Example: Media and Entertainment

Complete List

Niche​

  • Key: niche
  • Data Type: string
  • Premium: false
  • Description: Our AI infers a company’s niche by analyzing its website and other public data sources, categorizing it into a specific subcategory within an industry. This value is derived automatically, rather than being self-reported.
  • Example: Dairy Farming, Food Production, Plastics Manufacturing

Complete List

Headquarters Locations​

United States State Codes​

  • Key: unitedStatesHeadquartersStateCodes
  • Data Type: Array of <string>
  • Premium: false
  • Description: The U.S. state codes where the company's headquarters are located, if applicable.
  • Example: ["CA"]

Complete List

United States Cities​

  • Key: unitedStatesHeadquartersCities
  • Data Type: Array of <string>
  • Premium: false
  • Description: An array of U.S. cities where the company's headquarters are located.
  • Example: ["San Francisco"]

United States Regions​

  • Key: unitedStatesHeadquartersRegions
  • Data Type: Array of <string>
  • Premium: false
  • Description: Details geographical locations of company headquarters in the United States.
  • Example: ["West Coast"]

Complete List

Country Codes​

  • Key: headquartersCountryCodes
  • Data Type: Array of <string>
  • Premium: false
  • Description: The country codes where the company's headquarters are located, compliant with ISO 3166-1 alpha-2.
  • Example: ["US"]

Complete List

World Region​

  • Key: headquartersWorldRegions
  • Data Type: Array of <string>
  • Premium: false
  • Description: Details geographical locations of company headquarters globally.
  • Example: ["MENA"]

Complete List

Signals​

  • Key: signals
  • Data Type: Array of <string>
  • Premium: true
  • Description: Our AI analyzes the company's profiles, websites, job descriptions, social media, and other public information to infer signals about the company. These signals are automatically derived rather than self-reported, ensuring a higher fill rate and improved accuracy.
  • Example:
[
  "Culture: Health Insurance",
  "Business: B2B",
  "Business: Pay-As-You-Go",
  "Business: Demo Wall",
  "Offering: Digital Product Sampling Software",
  "Business: Has Integration Page"
]

Complete List

Example​

{
  "id": "9e6a55b258ef11edb8780242ac120002",
  "name": "Acme Corporation",
  "logoUrl": "https://d1hbpr09pwz0sk.cloudfront.net/logo_url/607a654e",
  "headcount": 35,
  "stockSymbol": "ACME",
  "website": "https://acmecorp.com",
  "angellistUrl": "https://angel.co/acmecorp",
  "crunchbaseUrl": "https://www.crunchbase.com/organization/acmecorp",
  "facebookUrl": "https://facebook.com/acmecorp",
  "githubUrl": "https://github.com/acmecorp",
  "linkedInUrl": "https://linkedin.com/company/acmecorp",
  "xUrl": "https://twitter.com/acmecorp",
  "youtubeUrl": "https://youtube.com/user/acmecorp",
  "industry": "Technology",
  "niche": "Cloud Computing",
  "unitedStatesHeadquartersStateCodes": ["CA"],
  "unitedStatesHeadquartersCities": ["San Francisco"],
  "unitedStatesHeadquartersRegions": ["East Coast"],
  "headquartersCountryCodes": ["US"],
  "headquartersWorldRegions": ["North America"],
  "signals": [
    "Culture: Health Insurance",
    "Business: B2B",
    "Business: Pay-As-You-Go",
    "Business: Demo Wall",
    "Offering: Digital Product Sampling Software",
    "Business: Has Integration Page"
  ]
}