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
  • Description: The company's name, including any suffixes such as "Inc." if applicable.
  • Example: Acme Inc.

Clean Name​

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

Logo Url​

  • Key: logoUrl
  • Data Type: url
  • 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
  • Description: The total number of employees working at the company.
  • Example: 22

Website​

  • Key: website
  • Data Type: url
  • 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
  • Description: URL to an AngelList profile.
  • Format: https://angel.co/[handle]
  • Example: https://angel.co/acme

Crunchbase URL​

  • Key: crunchbaseUrl
  • Data Type: url
  • 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
  • Description: URL to a Facebook profile.
  • Format: https://facebook.com/[username]
  • Example: https://facebook.com/acme

Github URL​

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

LinkedIn URL​

  • Key: linkedInUrl
  • Data Type: url
  • 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
  • Description: URL to an X (Twitter) profile.
  • Format: https://twitter.com/[username]
  • Example: https://twitter.com/acme

Youtube URL​

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

Headquarters Locations​

United States State Codes​

  • Key: unitedStatesHeadquartersStateCodes
  • Data Type: Array of <string>
  • 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>
  • 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>
  • 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>
  • 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>
  • Description: Details geographical locations of company headquarters globally.
  • Example: ["MENA"]

Complete List

Traits​

  • Key: traitKeys
  • Data Type: Array of <string>
  • Description: Our AI analyzes the company's profiles, websites, job descriptions, social media, and other public information to infer traits about the company. These traits are automatically derived rather than self-reported, ensuring a higher fill rate and improved accuracy.
  • Example:
 [
  "businessModelB2C",
  "businessModelD2C",
  "businessModelTypeSubscription",
  "businessModelTypeAffiliateMarketing",
  "businessProductServiceModelSubscriptionServices",
  "businessPricingStrategyPromotionalPricing",
  "businessPricingStrategySubscriptionPricing",
  "businessPricingStrategyVolumeDiscount",
  "cultureBenefitEmployeeDiscounts",
  "cultureBenefitRemoteWorkOptions",
  "cultureBenefitHealthInsurance",
  "cultureBenefitPaidTimeOff",
  "cultureBenefitParentalLeave",
  "cultureBenefitRetirementPlan",
  "cultureBenefitWorkLifeBalance",
  "cultureESGBenefitCorporation",
  "cultureWorkModeInternationalTeam",
  "cultureWorkplaceTransparencyAccountability",
  "legalEntityTypeInc",
  "legalFormationFormedInUS",
  "legalFormationHasLegalFormationDate",
  "legalFormationFormed10YearsAgo",
  "legalFormationHasBusinessRegistrationNumber",
  "legalIpHasRegisteredTrademarks",
  "legalIpMediumTrademarkPortfolio",
  "legalOwnershipPrivate",
  "websiteExternalLinkCategoryAdvertisingAndMarketing",
  "websiteExternalLinkCategoryFinance",
  "websiteExternalLinkCategoryNewspaper",
  "websiteExternalLinkCategoryScience",
  "websiteStructureHasManyInternalLinks",
  "websiteHasPageHasAboutWebPage",
  "websiteHasPageHasProductWebPage",
  "websiteTopLevelDomainGeneric",
  "financeFundingRangeTotalFunding50M200M",
  "financeRevenueRange100M1B",
  "financeRevenueBenchmarkRevenuePerEmployee300K1M",
  "financeInformationTechnologySpendingRange1M5M"
]

Complete List

Signals​

  • Key: signalKeys
  • Data Type: Array of <string>
  • Description: Our AI generates signals based on the inferred traits, providing insights into the company's historic and current state or behavior.
  • Example:
[
  "websiteTrafficRankGloballyRankingImprovedBy20LastMonthGlobally",
  "websiteHasPageAddedAboutPageLast3Months",
  "websiteHasPageAddedProductPageLast3Months",
  "websiteHasPageAddedANewPageLast3Months",
  "financeFundingRangeFundingSurpassed50M",
  "financeRevenueRangeRevenueSurpassed100M",
  "financeInformationTechnologySpendingRangeItSpendSurpassed1M"
]

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",
  "unitedStatesHeadquartersStateCodes": ["CA"],
  "unitedStatesHeadquartersCities": ["San Francisco"],
  "unitedStatesHeadquartersRegions": ["East Coast"],
  "headquartersCountryCodes": ["US"],
  "headquartersWorldRegions": ["North America"],
  "traitKeys": [
    "businessModelB2C",
    "businessModelD2C",
    "businessModelTypeSubscription",
    "businessModelTypeAffiliateMarketing",
    "businessProductServiceModelSubscriptionServices",
    "businessPricingStrategyPromotionalPricing",
    "businessPricingStrategySubscriptionPricing",
    "businessPricingStrategyVolumeDiscount",
    "cultureBenefitEmployeeDiscounts",
    "cultureBenefitRemoteWorkOptions",
    "cultureBenefitHealthInsurance",
    "cultureBenefitPaidTimeOff",
    "cultureBenefitParentalLeave",
    "cultureBenefitRetirementPlan",
    "cultureBenefitWorkLifeBalance",
    "cultureESGBenefitCorporation",
    "cultureWorkModeInternationalTeam",
    "cultureWorkplaceTransparencyAccountability",
    "legalEntityTypeInc",
    "legalFormationFormedInUS",
    "legalFormationHasLegalFormationDate",
    "legalFormationFormed10YearsAgo",
    "legalFormationHasBusinessRegistrationNumber",
    "legalIpHasRegisteredTrademarks",
    "legalIpMediumTrademarkPortfolio",
    "legalOwnershipPrivate",
    "websiteExternalLinkCategoryAdvertisingAndMarketing",
    "websiteExternalLinkCategoryFinance",
    "websiteExternalLinkCategoryNewspaper",
    "websiteExternalLinkCategoryScience",
    "websiteStructureHasManyInternalLinks",
    "websiteHasPageHasAboutWebPage",
    "websiteHasPageHasProductWebPage",
    "websiteTopLevelDomainGeneric",
    "financeFundingRangeTotalFunding50M200M",
    "financeRevenueRange100M1B",
    "financeRevenueBenchmarkRevenuePerEmployee300K1M",
    "financeInformationTechnologySpendingRange1M5M"
  ],
  "signalKeys": [
    "websiteTrafficRankGloballyRankingImprovedBy20LastMonthGlobally",
    "websiteHasPageAddedAboutPageLast3Months",
    "websiteHasPageAddedProductPageLast3Months",
    "websiteHasPageAddedANewPageLast3Months",
    "financeFundingRangeFundingSurpassed50M",
    "financeRevenueRangeRevenueSurpassed100M",
    "financeInformationTechnologySpendingRangeItSpendSurpassed1M"
  ]
}