Enrich Companies

Endpoint

This endpoint returns an array of company object model. The company is identified id or linkedInUrl.

• URL: https://api.profileapi.com/2024-03-01/companies/enrich
• HTTP Method: POST

Request

Parameters

To enrich a company, specify either id, or linkedInUrl.

Ids (Option A)

• Key: ids
• Data Type: Array of <string>
• Description: An array of universally unique identifier (UUID) compliant with RFC 4122 specification, used to uniquely identify entities in the system. Presented without hyphens.
• Example: ["9e6a55b258ef11edb8780242ac120002"]

LinkedIn URLs (Option B)

• Key: linkedInUrls
• Data Type: Array of <string>
• Description: URL to a LinkedIn profile.
• Format: https://linkedin.com/company/[handle]
• Example: [ "https://linkedin.com/company/acme" ]

important

You can only pass either option A or B, but not both. There is a maximum of 100 ids or linkedInUrls

Fields To Return

• Key: fieldsToReturn
• Data Type: string
• Description: The fields to return
• Options:

Name	Default	Credits Per Company	Description
basic	true	1	Basic company information such as company Name, Website, Links, Headquarters Locations
premium	false	4	Premium company information to include AI generated signals

Please refer to company object model for a list of basic vs premium fields.

Example

{
  "ids": ["9e6a55b258ef11edb8780242ac120002"],
  "fieldsToReturn": "premium"
}

{
  "linkedInUrls": ["https://linkedin.com/company/acme"],
  "fieldsToReturn": "premium"
}

info

You will only be charged a credit on success. If we don't find the company, you will not be charged.

Response

The response includes an array of company object model.

Example

{
  "data": {
    "results": [
      {
        "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": [
          {
            "type": "Benefit",
            "signal": "Employ Health Insurance"
          },
          {
            "type": "Business Model",
            "signal": "Deploy Pay-As-You-Go"
          },
          {
            "type": "Business Model Type",
            "signal": "Deploy B2M Solutions"
          },
          {
            "type": "Pricing Strategy",
            "signal": "Deploy Demo Wall Strategy"
          },
          {
            "type": "Product Category",
            "signal": "Offer Digital Products"
          },
          {
            "type": "Target Department",
            "signal": "Sell to Accounting Department"
          },
          {
            "type": "Website Pages",
            "signal": "Has Integration Page"
          }
        ]
      }
    ],
    "pagination": {
      "nextStart": [
        {
          "id": "9e6a55b258ef11edb8780242ac121233",
          "score": 0.92
        }
      ]
    }
  }
}