Introduction

Welcome to the PrivCo API Documentation. You can find steps to Authenticate with a provided API key, how to identify companies using the Search endpoint, and a general reference of available endpoints that best suit your data needs.

Please feel free to contact the PrivCo Development Team with any questions.

Authentication

Curl example:

curl -X GET --header 'Accept: application/json' --header 'x-api-key: YOUR_KEY' 'https://api.privco.com/v2/general_profile/company/9203'

Make sure to replace YOUR_KEY with your API key.

To use the API with your own application, please add the provided API key to the 'x-api-key' property in the request header that looks like the following:

x-api-key: YOUR_KEY

Search

Search by name or website to get the corresponding profile ID.

The endpoint returns JSON structured like this:

{
  "data": [
      {
          "name": "Airblade",
          "profile_id": 35001,
          "profile_type": "Company",
          "profile_classification": "Private",
          "permalink": "http://www.privco.com/private-company/dyson",
          "location": "United Kingdom",
          "industry": "Manufacturing & Industrial",
          "website": [
              "www.dyson.com"
          ]
      },
      {
          "name": "AirWatch, LLC",
          "profile_id": 137280,
          "profile_type": "Company",
          "profile_classification": "Private",
          "permalink": "http://www.privco.com/private-company/airwatch",
          "location": "United States",
          "industry": "Technology",
          "website": [
              "www.Air-Watch.com"
          ]
      }
    ]
}

HTTP Request

GET https://api.privco.com/v2/search/{name}

Ex: https://api.privco.com/v2/search/air

Ex: https://api.privco.com/v2/search?name=air

Ex: https://api.privco.com/v2/search?website=airbnb.com

Ex: https://api.privco.com/v2/search?name=air&page=2

Query Parameters

Options	Default	Description
name		Search by using the company name.
website		Search by using the company website.
page		If there are more than 20 results returned, you can specify a page number to view the next page.

General Profile

Get the general company or investor profile

The endpoint returns JSON structured like this:

{
  "data": {
    "name": "LL Bean",
    "profile_type": "Company",
    "profile_id": 9203,
    "profile_classification": "Private",
    "permalink": "https://www.privco.com/private-company/ll-bean",
    "address": {
      "addr1": "15 Casco Street",
      "addr2": "",
      "city": "Freeport",
      "state": "ME",
      "zip_code": "04033",
      "country": "United States",
      "area_code": "",
      "phone": "207-865-4761",
      "fax": "207-552-2802"
    },
    "company_type": "CORPORATION",
    "summary": "LL Bean Inc.is a privately-held manufacturer and retailer of apparel, equipment, and outdoor gear. The company provides a range of goods for various outdoor activities. LL Bean also offers indoor as well as outdoor home furniture and accessories. It sells its products through its retail stores, catalogs, and online. Founded in 1912 by Leon Leonwood Bean, LL Bean is headquartered in Freeport, Maine.",
    "industry": "Consumer Products",
    "website": [
      "www.llbean.com"
    ],
    "latest_revenues": 1600000000,
    "latest_revenues_currency": "USD",
    "latest_revenues_year": 2016,
    "latest_employees": 5900,
    "latest_employees_year": 2016,
    "total_funding": 0,
    "total_funding_currency": "",
    "parent_company": [],
    "subsidiary": [],
    "partner": [],
    "sister_company": [],
    "dba": [],
    "aka": [
      {
        "name": "L.L. Bean",
        "profile_type": "",
        "profile_id": ""
      }
    ],
    "former_name": [],
    "competitors": [
      {
        "name": "Brooks Brothers, Inc.",
        "profile_type": "Company",
        "profile_id": "42470"
      },
      {
        "name": "Bubba Brands, Inc.",
        "profile_type": "Company",
        "profile_id": "616743"
      },
      {
        "name": "Buffalo Jackson Trading Company",
        "profile_type": "Company",
        "profile_id": "264864"
      }
    ],
    "founder": [
      {
        "name": "Leon Leonwood Bean"
      }
    ],
    "owner": [
      {
        "name": "Bean Family & Descendants"
      }
    ],
    "contacts": [
      {
        "title": "Senior Talent Specialist",
        "name": "Tammy Noyes",
        "email": "tnoyes@llbean.com"
      },
      {
        "title": "CEO/President",
        "name": "Stephen Smith",
        "email": "ssmith@llbean.com"
      },
      {
        "title": "Chairman",
        "name": "Shawn Gorman",
        "email": "sgorman@llbean.com"
      },
      {
        "title": "Chief Financial Officer",
        "name": "Mark Fasold",
        "email": "mfasold@llbean.com"
      },
      {
        "title": "SVP & General Manager of Retail",
        "name": "Ken Kacere",
        "email": "kkacere@llbean.com"
      },
      {
        "title": "Chief Information Officer",
        "name": "Jean Wilson",
        "email": "jwilson@llbean.com"
      },
      {
        "title": "SVP of Direct Channel",
        "name": "Chris Wilson",
        "email": "cwilson@llbean.com"
      },
      {
        "title": "Manager - Public Affairs",
        "name": "Carolyn Beem",
        "email": "cbeem@llbean.com"
      }
    ],
    "investors": []
  }
}

This endpoint retrieves a general company or investor profile including most recent year's Employees and Revenues, and Total Funding. For additional line items, in-depth historical Financials and KPIs please see the "Financials" call. For detailed Funding and M&A deal activity, please see the "Deals" call.

HTTP Request

GET https://api.privco.com/v2/general_profile/{profile_type}/{profile_id}

Ex: https://api.privco.com/v2/general_profile/company/9203

Ex: https://api.privco.com/v2/general_profile/investor/4087

Query Parameters

Options	Default	Description
profile_type		Specify the profile type: company or investor
profile_id		This is the id of the company or investor profile, which can be obtained using the Search API endpoint

Financials

Get detailed Financials, KPIs, and growth rates for the company (all available data points).

The endpoint returns JSON structured like this:

{
  "data": [
    {
      "company_profile_id": 9203,
      "title": "Revenues",
      "currency": "USD",
      "column": "2016",
      "value": "1600000000"
    },
    {
      "company_profile_id": 9203,
      "title": "Employees",
      "currency": "",
      "column": "2016",
      "value": "5900"
    },
    {
      "company_profile_id": 9203,
      "title": "Revenues",
      "currency": "USD",
      "column": "2015",
      "value": "1600000000"
    },
    {
      "company_profile_id": 9203,
      "title": "Employees",
      "currency": "",
      "column": "2015",
      "value": "5500"
    },
    {
      "company_profile_id": 9203,
      "title": "U.S. Locations",
      "currency": "",
      "column": "2015",
      "value": "40"
    },
  ],
  "growth_rates": {
    "revenue_growth_rate_1yr": -0.625,
    "revenue_growth_rate_3yr": 0.637,
    "employee_growth_rate_1yr": 0.8475,
    "employee_growth_rate_3yr": 3.9315
  },
  "privco_tier": "Gold"
}

HTTP Request

GET https://api.privco.com/v2/financials/{profile_type}/{profile_id}

Ex: https://api.privco.com/v2/financials/company/9203

Ex: https://api.privco.com/v2/financials/company/9203?year=2016&title=Revenues

Query Parameters

Options	Default	Description
profile_type		Specify the profile type: company
profile_id		This is the id of the company profile.
year		Gets results based on a specific year.
title		Gets results based on a specific title.

Deals

Get all available VC funding and M&A deals for the company.

The endpoint returns JSON structured like this:

{
  "data": {
    "vc_funding": [
      {
        "target_company_id": 78,
        "target_company_name": "Airbnb, Inc.",
        "vc_deal_id": 215068,
        "round": "F",
        "currency": "USD",
        "total": "447800000",
        "date": {
          "month": "3",
          "day": "9",
          "year": "2017"
        },
        "investors": [
          {
            "investor_name": "Alfred Lin",
            "investor_profile_id": "10283",
            "investor_profile_type": "Investor"
          },
          {
            "investor_name": "Jeff Jordan",
            "investor_profile_id": "0",
            "investor_profile_type": "None"
          },
          {
            "investor_name": "Technology Crossover Ventures",
            "investor_profile_id": "638",
            "investor_profile_type": "Investor"
          },
          {
            "investor_name": "Google Capital",
            "investor_profile_id": "15665",
            "investor_profile_type": "Investor"
          }
        ]
      }
    ],
    "ma_deals": [
    {
      "ma_deal_id": 105988,
      "deal_role": "Buyer",
      "date": {
        "month": "6",
        "day": "16",
        "year": "2017"
      },
      "percent_acquired": "100",
      "currency": "USD",
      "valuation": "",
      "price": "",
      "price_component_cash": "",
      "target": [
        {
          "target_name": "Trooly, Inc.",
          "target_profile_id": "1047579",
          "target_profile_type": "Company"
        }
      ],
      "buyer": [
        {
          "buyer_name": "Airbnb, Inc.",
          "buyer_profile_id": "78",
          "buyer_profile_type": "Company"
        }
      ],
      "seller": [
        {
          "seller_name": "Milliways Ventures",
          "seller_profile_id": "20723",
          "seller_profile_type": "Investor"
        },
        {
          "seller_name": "Bain Capital Ventures",
          "seller_profile_id": "1255",
          "seller_profile_type": "Investor"
        }
      ]
    }
  ]
}

HTTP Request

GET https://api.privco.com/v2/deals/{profile_type}/{profile_id}

Ex: https://api.privco.com/v2/deals/company/9203

Ex: https://api.privco.com/v2/deals/investor/4087

Query Parameters

Options	Default	Description
profile_type		Specify the profile type: company or investor
profile_id		This is the id of the company profile.

Usage

Check your API usage for the current period.

The endpoint returns JSON structured like this:

{
    "data": {
        "unique_profile": {
            "refresh_period": "monthly",
            "total_quota": 86,
            "used_this_period": 36,
            "remaining_this_period": 50
        },
        "calls": {
            "refresh_period": "monthly",
            "general_profile": {
                "total_quota": 176,
                "used_this_period": 1,
                "remaining_this_period": 175
            },
            "financials": {
                "total_quota": 10000,
                "used_this_period": 0,
                "remaining_this_period": 10000
            },
            "deals": {
                "total_quota": 1000,
                "used_this_period": 1,
                "remaining_this_period": 999
            }
        },
        "subscription_start": "2016-09-30",
        "subscription_end": "2019-09-30"
    },
    "meta": {
        "call": "usage",
        "status": "success",
        "current_time": 1513789998538
    }
}

HTTP Request

GET https://api.privco.com/v2/usage

Errors

HTTP Error Codes

Code		Description
400	Bad Request	You have entered an invalid command.
401	Unauthorized	API key is missing or wrong.
403	Forbidden	You don't have permissions for that action, or subscription is expired.
500	Internal Server Error	We experienced a problem with our server. Please try again.