Documentation

Company Profile Endpoint

Look up a company by its LinkedIn company or showcase page URL.

GET
/v3/company

Authorization

BearerAuth
AuthorizationBearer <token>

Enrich Layer API key, sent as Authorization: Bearer <key>

In: header

Query Parameters

url*string

LinkedIn company or showcase page URL to look up

fundingData?string

Include the funding rounds, returned in the funding.rounds section

Default"exclude"
Value in"exclude" | "include"
exitData?string

Include the exit events, returned in the exits section

Default"exclude"
Value in"exclude" | "include"
acquisitions?string

Include the companies acquired and the acquirer, returned in the acquisitions section

Default"exclude"
Value in"exclude" | "include"
extra?string

Include the extra profile details: the Crunchbase URL, rounds count, total funding and investor count in the funding.summary section, the ticker symbol and IPO status in the stock section, and the contact email and Crunchbase link in the contactInformation section

Default"exclude"
Value in"exclude" | "include"
activities?string

Include up to 100 of the most recent posts from the company page, newest first with undated posts last, returned in the activities section

Default"exclude"
Value in"exclude" | "include"
maxAgeSeconds?integer

Maximum acceptable age of cached data, in seconds.

Default2592000
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.enrichlayer.com/v3/company?url=https%3A%2F%2Flinkedin.com%2Fcompany%2Fmicrosoft%2F&fundingData=include&maxAgeSeconds=86400" \  -H "Authorization: Bearer YOUR_API_KEY"
{
  "summary": {
    "name": "string",
    "logo": "string",
    "tagline": "string",
    "industry": "string",
    "location": "string",
    "employeeCount": 0,
    "websiteUrl": "string"
  },
  "name": "string",
  "tagline": "string",
  "description": "string",
  "websiteUrl": "string",
  "foundedYear": 0,
  "companyType": "string",
  "specialties": [
    "string"
  ],
  "slug": {
    "linkedin": "string",
    "twitter": "string",
    "facebook": "string",
    "crunchbase": "string"
  },
  "profileImageUrl": {
    "linkedin": "string"
  },
  "backgroundImageUrl": {
    "linkedin": "string"
  },
  "industries": [
    {
      "id": 0,
      "value": "string",
      "primary": true
    }
  ],
  "naicsCodes": [
    {
      "code": "string",
      "title": "string"
    }
  ],
  "location": {
    "country": "string",
    "countryIso3": "string",
    "countryFullName": "string",
    "city": "string",
    "state": "string",
    "stateFullName": "string",
    "postalCode": "string",
    "line1": "string",
    "rawLocationString": "string",
    "coordinates": {
      "latitude": 0,
      "longitude": 0
    },
    "type": "string"
  },
  "locations": [
    {
      "country": "string",
      "countryIso3": "string",
      "countryFullName": "string",
      "city": "string",
      "state": "string",
      "stateFullName": "string",
      "postalCode": "string",
      "line1": "string",
      "rawLocationString": "string",
      "coordinates": {
        "latitude": 0,
        "longitude": 0
      },
      "type": "string"
    }
  ],
  "domain": {
    "resolved": "string",
    "original": "string"
  },
  "companySize": {
    "range": [
      0
    ],
    "linkedinCode": "string",
    "employeeCountOnLinkedin": 0,
    "employeeCountOverTime": [
      {
        "date": "string",
        "value": 0
      }
    ],
    "organizationSizeOverTime": [
      {
        "date": "string",
        "value": 0
      }
    ]
  },
  "headcountGrowthMetrics": {
    "quarterlyGrowthRate": 0,
    "annualGrowthRate": 0,
    "trend": "string",
    "velocity": "string",
    "lastComputedAt": "string"
  },
  "contactInformation": {
    "emails": [
      {
        "email": "string",
        "normalized": "string",
        "validity": "string",
        "validatedAt": "string",
        "type": "string"
      }
    ],
    "phoneNumbers": [
      "string"
    ],
    "socialLinks": {
      "linkedinUrl": "string",
      "facebookUrl": "string",
      "twitterUrl": "string",
      "crunchbaseUrl": "string",
      "websiteUrl": "string"
    }
  },
  "socialPresence": {
    "followers": {
      "total": 0,
      "linkedin": 0
    },
    "followerCountOverTime": [
      {
        "date": "string",
        "value": 0
      }
    ]
  },
  "linkedinJobs": {
    "totalOverTime": [
      {
        "date": "string",
        "value": 0
      }
    ]
  },
  "activities": {
    "posts": [
      {
        "title": "string",
        "url": "string",
        "publishedDate": "string",
        "likes": 0,
        "comments": 0
      }
    ]
  },
  "similarCompanies": [
    {
      "name": "string",
      "slug": {
        "linkedin": "string",
        "twitter": "string",
        "facebook": "string",
        "crunchbase": "string"
      },
      "industries": [
        {
          "id": 0,
          "value": "string",
          "primary": true
        }
      ],
      "location": {
        "country": "string",
        "countryIso3": "string",
        "countryFullName": "string",
        "city": "string",
        "state": "string",
        "stateFullName": "string",
        "postalCode": "string",
        "line1": "string",
        "rawLocationString": "string",
        "coordinates": {
          "latitude": 0,
          "longitude": 0
        },
        "type": "string"
      },
      "url": "string"
    }
  ],
  "affiliatedCompanies": [
    {
      "name": "string",
      "slug": {
        "linkedin": "string",
        "twitter": "string",
        "facebook": "string",
        "crunchbase": "string"
      },
      "industries": [
        {
          "id": 0,
          "value": "string",
          "primary": true
        }
      ],
      "location": {
        "country": "string",
        "countryIso3": "string",
        "countryFullName": "string",
        "city": "string",
        "state": "string",
        "stateFullName": "string",
        "postalCode": "string",
        "line1": "string",
        "rawLocationString": "string",
        "coordinates": {
          "latitude": 0,
          "longitude": 0
        },
        "type": "string"
      },
      "url": "string",
      "relationship": "string"
    }
  ],
  "funding": {
    "summary": {
      "crunchbaseUrl": "string",
      "lastRoundDate": "string",
      "lastRoundType": "string",
      "roundsCount": 0,
      "totalFundingAmountUsd": 0,
      "numberOfInvestors": 0,
      "numberOfLeadInvestors": 0
    },
    "rounds": [
      {
        "fundingType": "string",
        "moneyRaised": 0,
        "currency": "string",
        "announcedDate": "string",
        "numberOfInvestors": 0,
        "investors": [
          {
            "name": "string",
            "type": "string",
            "url": "string",
            "isLead": true
          }
        ]
      }
    ],
    "roundsCountOverTime": [
      {
        "date": "string",
        "value": 0
      }
    ]
  },
  "stock": {
    "exchange": "string",
    "tickerSymbol": "string",
    "ipoDate": "string",
    "ipoStatus": "string"
  },
  "acquisitions": {
    "acquired": [
      {
        "company": {
          "name": "string",
          "slug": {
            "linkedin": "string",
            "twitter": "string",
            "facebook": "string",
            "crunchbase": "string"
          },
          "url": "string"
        },
        "announcedDate": "string",
        "price": 0,
        "currency": "string",
        "priceUsd": 0
      }
    ],
    "acquiredBy": {
      "company": {
        "name": "string",
        "slug": {
          "linkedin": "string",
          "twitter": "string",
          "facebook": "string",
          "crunchbase": "string"
        },
        "url": "string"
      },
      "announcedDate": "string",
      "price": 0,
      "currency": "string",
      "priceUsd": 0
    }
  },
  "exits": [
    {
      "company": {
        "name": "string",
        "slug": {
          "linkedin": "string",
          "twitter": "string",
          "facebook": "string",
          "crunchbase": "string"
        },
        "url": "string"
      }
    }
  ],
  "meta": {
    "updatedAt": "string"
  }
}

{
  "code": 400,
  "name": "Bad Request",
  "description": "Please provide valid parameters"
}

{
  "code": 401,
  "name": "Unauthorized",
  "description": "Invalid API key"
}

{
  "code": 403,
  "name": "Forbidden",
  "description": "Account has been suspended. Please email [email protected] for more information."
}

{
  "code": 404,
  "name": "Not Found",
  "description": "Company not found"
}
{
  "code": 409,
  "name": "Conflict",
  "description": "A fresh profile could not be fetched; a cached profile exists but is older than the requested maxAgeSeconds. Retry the request, or raise maxAgeSeconds to accept the cached profile.",
  "cachedProfileAgeSeconds": 5184000
}
{
  "code": 429,
  "name": "Too Many Requests",
  "description": "Rate limit exceeded. See https://enrichlayer.com/docs/guides/rate-limits"
}
{
  "code": 500,
  "name": "Internal Server Error",
  "description": "Failed to fetch data"
}
{
  "code": 503,
  "name": "Service Unavailable",
  "description": "Billing service unavailable"
}