Investors¶

Query¶

Looking to find which investors have done the most deals in a specific geographic region? Which investors have raised more than $20M in the past three years? This is the endpoint you’ll want to dig into. Before you start making requests to this endpoint its recommended to read up on our MSFL filtering language. For an exhaustive list of the fields you can query, scroll down past the example response below.

POST https://api.mattermark.com/queries

Example Request¶

Question: “Which investors are located in California?”

{
    "dataset": "investor",
    "filter": {
        "state": "CA"
    }
}

Question: “Which investors have invested in the “big data” and “cloud computing” industries?”

{
    "dataset": "investor",
    "filter": {
        "foreign": {
            "dataset": "company",
            "filter": {
                "industries": {
                    "in": ["Cloud Computing","Crowdfunding"]
                }
            }
        }
    }
}

Example Response¶

{
    "meta": {
        "total_record_count":10682,
        "total_pages":214,
        "current_page":1,
        "per_page":50
    },
    "query_id":"ndrJ1lUaoabdAb8XBN7Fbg00Eyz4g9TnitQ60ulwAS532EXajCjTcHk6d6PuCMwmLdELYBVWZhZ0rwIM3FdA",
    "query": {
        "urlsafe_query_hash":"ndrJ1lUaoabdAb8XBN7Fbg00Eyz4g9TnitQ60ulwAS532EXajCjTcHk6d6PuCMwmLdELYBVWZhZ0rwIM3FdA",
        "dataset":"investor",
        "filter": {
            "type": {
                "in": ["vc", "angel", "accelerator"]
            }
        },
        "sort": [{"portfolio_size": "desc"}]
    },
    "results":[
        {
            "investor_id": 859,
            "name": "Tiger Global Management",
            "investor_domain": null,
            "location": "New York",
            "three_year_funds_offered": 4038097180,
            "three_year_funds_sold": 3031096150,
            "est_most_recent_fund_date": "2014-11-26",
            "type": "vc",
            "most_recent_deal": "2015-04-20",
            "number_of_deals": 128,
            "portfolio_size": 80,
            "avg_growth_score": 4255.6375,
            "city": "New York",
            "state": "NY",
            "country": "USA",
            "website": null,
            "mm_slug": "tiger-global-management",
            "industries":["advertising","banking","big data","career / job search","classifieds","cloud computing","consulting","consumer services","crowdfunding","customer support","data storage","deals","e-commerce","education","enterprise software","entertainment","fashion","finance","food & beverages","gaming","hardware","hospitality","household & personal products","human resources","human resources hr","insurance","internet","lending","market research","marketing","media","mobile","music","payments","personal products","publishing","real estate","retail","search","security","social networking","software","software development","storage","transportation","travel"],
            "deals_per_company": 1.6,
            "resource_type": "investor"
        },{
            "investor_id": 74,
            "name": "New Enterprise Associates",
            "investor_domain": "nea.com",
            "location": "Bay Area",
            "three_year_funds_offered": 4038097180,
            "three_year_funds_sold": 3031096150,
            "est_most_recent_fund_date": "2015-04-15",
            "type": "vc",
            "most_recent_deal": "2015-04-21",
            "number_of_deals": 703,
            "portfolio_size": 449,
            "avg_growth_score": 464.19599109131406,
            "city": "Menlo Park",
            "state": "CA",
            "country": "USA",
            "website": "nea.com",
            "mm_slug": "NEA",
            "industries":["advertising","agriculture","analytics","automotive","banking","big data","biotechnology","biotechnology ","career / job search","classifieds","cleantech","cloud computing","communications equipment","computer hardware","consumer electronics","consumer services","crowdfunding","customer support","dating","deals","drones","e-commerce","education","energy","enterprise software","entertainment","event","fashion","finance","food & beverages","gaming","government","hardware","hardware ","health insurance","health it","healthcare","healthcare ","hospitality","human resources","human resources hr","information security","insurance","internet","internet of things","legal","lending","machine learning","market research","marketing","marketing analytics","media","medical devices","medical diagnostics","mobile","music","network / hosting / infrastructure","payments","pharmaceuticals","pharmaceuticals ","professional services","publishing","real estate","retail","search","security","semiconductors","semiconductors ","social networking","software","software development","solar power","storage","telecommunications","telecommunications ","transportation","travel","virtual reality","wearables","wind power"],
            "deals_per_company":1.2,
            "resource_type":"investor"
        }]}

Query Fields¶

The following fields can be used in the MSFL filter portion of the query to limit the result set.

Investor Fields

These fields are properties about the investor. With these fields you can answer simple questions such as “What investors are located in London?” or “What angel investors are located in Argentina?”.

investor_id
name
investor_domain
location
type (such as vc, angel, or accelerator)
city
state
country
website

Aggregate Fields

These field are aggregates about other objects related to investors. Using these query fields you can answer questions such as “What investors have more than 50 portfolio companies?” or “What investors have done a deal in the last 3 months?”.

three_year_funds_offered
three_year_funds_sold
est_most_recent_fund_date
most_recent_deal
number_of_deals
portfolio_size
avg_growth_score
deals_per_company

Details¶

This endpoint will give you details for a specific investor. Information includes the size of their portfolio and some stats around their portfolio and funding deals.

GET /investors/[:id]

Example Request¶

$ curl "https://api.mattermark.com/investors/30?key=[YOUR KEY]

Example Response¶

{
  "id": 51,
  "name": "Greycroft Partners",
  "mm_slug": "Greycroft",
  "website": "greycroft.com",
  "type": "vc",
  "location": "New York",
  "portfolio_path": "/app/data?investors=Greycroft",
  "portfolio_size": 172,
  "number_of_deals": 244,
  "three_year_funds_sold": 381160001,
  "funding_rounds_path": "/app/rounds?investors=Greycroft",
  "est_most_recent_fund_date": "2015-11-30",
  "most_recent_funding": {
    "funding_date": "2016-02-04",
    "amount": 2250000,
    "series": "seed",
    "company": { "id": 10579847, "company_name": "Hobnob" },
    "investors": [
      { "mm_slug": "Greycroft", "display_name": "Greycroft Partners" },
      { "mm_slug": "Bessemer", "display_name": "Bessemer Venture Partners" },
      { "mm_slug": "aspect-ventures", "display_name": "Aspect Ventures" },
      { "mm_slug": "norwest", "display_name": "Norwest Venture Partners" }
    ]
  },
  "portfolio_aggregates": {
    "stages": [
      { "name": "a", "count": 42 },
      { "name": "Exited (Acquired)", "count": 41 },
      { "name": "Pre Series A", "count": 36 },
      { "name": "b", "count": 24 },
      { "name": "Late", "count": 15 },
      { "name": "c", "count": 8 },
      { "name": "Exited (Other)", "count": 2 },
      { "name": "Unknown", "count": 2 },
      { "name": "Exited (IPO)", "count": 1 },
      { "name": "No Known Funding", "count": 1 }
    ],
    "locations": [
      { "name": "new york", "count": 44 },
      { "name": "los angeles", "count": 37 },
      { "name": "bay area", "count": 31 },
      { "name": "london", "count": 6 },
      { "name": "chicago", "count": 4 },
      { "name": "salt lake city", "count": 4 },
      { "name": "austin", "count": 3 },
      { "name": "seattle", "count": 3 },
      { "name": "boston", "count": 2 },
      { "name": "raleigh", "count": 2 }
    ],
    "business_models": [
      { "name": "B2C", "count": 102 },
      { "name": "B2B", "count": 99 },
      { "name": "SaaS", "count": 15 },
      { "name": "Advertising", "count": 10 },
      { "name": "Marketplace", "count": 5 },
      { "name": "Consulting", "count": 2 },
      { "name": "Direct Sales", "count": 1 },
      { "name": "Events", "count": 1 },
      { "name": "Lead Generation", "count": 1 },
      { "name": "Metamediary", "count": 1 }
    ],
    "industries": [
      { "name": "E-Commerce", "count": 37 },
      { "name": "Mobile", "count": 36 },
      { "name": "Marketing", "count": 30 },
      { "name": "Advertising", "count": 28 },
      { "name": "Media", "count": 25 },
      { "name": "Gaming", "count": 20 },
      { "name": "Social Networking", "count": 17 },
      { "name": "Enterprise Software", "count": 16 },
      { "name": "Analytics", "count": 14 },
      { "name": "Finance", "count": 14 }
    ]
  },
  "deal_aggregates": {
    "series": [
      { "name": "a", "count": 86 },
      { "name": "", "count": 45 },
      { "name": "b", "count": 43 },
      { "name": "seed", "count": 27 },
      { "name": "c", "count": 17 },
      { "name": "venture", "count": 10 },
      { "name": "d", "count": 8 },
      { "name": "undisclosed", "count": 3 },
      { "name": "angel", "count": 1 },
      { "name": "convertible_note", "count": 1 }
    ],
    "quarterly": [
      {
        "2015-07-01": {
          "locations": [
            { "name": "minneapolis", "count": 1 },
            { "name": "new york", "count": 1 }
          ],
          "industries": [
            { "name": "Hospitality", "count": 2 },
            { "name": "E-Commerce", "count": 1 },
            { "name": "Enterprise Software", "count": 1 },
            { "name": "Food & Beverages", "count": 1 },
            { "name": "Healthcare", "count": 1 },
            { "name": "Human Resources", "count": 1 },
            { "name": "Human Resources (HR)", "count": 1 },
            { "name": "Mobile", "count": 1 },
            { "name": "Software Development", "count": 1 }
          ],
          "stages": [
            { "name": "a", "count": 2 },
            { "name": "b", "count": 1 }
          ],
          "business_models": [
            { "name": "B2C", "count": 2 },
            { "name": "B2B", "count": 1 },
            { "name": "Consulting", "count": 1 },
            { "name": "SaaS", "count": 1 }
          ]
        }
      },
      {
        "2015-04-01": {
          "locations": [
            { "name": "los angeles", "count": 4 },
            { "name": "new york", "count": 4 },
            { "name": "bay area", "count": 2 },
            { "name": "london", "count": 2 },
            { "name": "austin", "count": 1 },
            { "name": "chicago", "count": 1 },
            { "name": "seattle", "count": 1 }
          ],
          "industries": [
            { "name": "E-Commerce", "count": 4 },
            { "name": "Mobile", "count": 3 },
            { "name": "Analytics", "count": 2 },
            { "name": "Consumer Services", "count": 2 },
            { "name": "Finance", "count": 2 },
            { "name": "Gaming", "count": 2 },
            { "name": "Marketing", "count": 2 },
            { "name": "Retail", "count": 2 },
            { "name": "Banking", "count": 1 },
            { "name": "CleanTech", "count": 1 }
          ],
          "stages": [
            { "name": "a", "count": 9 },
            { "name": "Pre Series A", "count": 3 },
            { "name": "c", "count": 2 },
            { "name": "Late", "count": 1 },
            { "name": "b", "count": 1 }
          ],
          "business_models": [
            { "name": "B2C", "count": 8 },
            { "name": "B2B", "count": 7 },
            { "name": "Marketplace", "count": 1 },
            { "name": "SaaS", "count": 1 }
          ]
        }
      }
    ]
  },
  "top_industries": [
    {
      "industry_name": "e-commerce",
      "investments": 55
    },
    {
      "industry_name": "mobile",
      "investments": 53
    },
    {
      "industry_name": "marketing",
      "investments": 49
    },
    {
      "industry_name": "advertising",
      "investments": 44
    },
    {
      "industry_name": "media",
      "investments": 37
    }
  ],
  "most_recent_filings": [
    {
      "entity_name": "Greycroft Growth, L.P.",
      "total_offering": 200000000,
      "total_sold": 200000000,
      "filing_date": "2014-06-19",
      "form": "D"
    },
    {
      "entity_name": "GREYCROFT CO-INVEST EXTREME REACH, L.P.",
      "total_offering": 6160001,
      "total_sold": 6160001,
      "filing_date": "2014-02-12",
      "form": "D"
    },
    {
      "entity_name": "Greycroft Partners III, L.P.",
      "total_offering": 175000000,
      "total_sold": 175000000,
      "filing_date": "2012-11-27",
      "form": "D"
    },
    {
      "entity_name": "Greycroft Partners Annex Fund, L.P.",
      "total_offering": 12650000,
      "total_sold": 12650000,
      "filing_date": "2012-03-06",
      "form": "D"
    },
    {
      "entity_name": "Greycroft Partners II, L.P.",
      "total_offering": 128000000,
      "total_sold": 115075000,
      "filing_date": "2010-02-18",
      "form": "D"
    }
  ]
}

Investor Portfolio¶

Now that you found an investor your interested in you can use this endpoint to get a full run down of all the companies in their portfolio.

GET https://api.mattermark.com/investors/:id/portfolio

Example Request¶

$ curl "https://api.mattermark.com/investors/30/portfolio?key=[YOUR KEY]

Example Response¶

{
  "companies": [
    {
      "id": 285643,
      "company_name": "Medgenome Labs",
      "domain": "medgenome.com",
      "stage": "b",
      "location": "bangalore",
      "last_funding_date": "2015-07-22",
      "total_funding": 24000000,
      "investor_first_invested_on": "2015-07-22"
    },
    {
      "id": 10965875,
      "company_name": "KFit",
      "domain": "kfit.com",
      "stage": "Pre Series A",
      "location": "singapore",
      "last_funding_date": "2015-07-20",
      "total_funding": 3250000,
      "investor_first_invested_on": "2015-07-20"
    },
    {
      "id": 216637,
      "company_name": "Flipagram",
      "domain": "flipagram.com",
      "stage": "b",
      "location": "los angeles",
      "last_funding_date": "2015-07-15",
      "total_funding": 70000000,
      "investor_first_invested_on": "2015-07-15"
    },
    {
      "id": 10991757,
      "company_name": "Roadrunnr",
      "domain": "roadrunnr.in",
      "stage": "a",
      "location": "bangalore",
      "last_funding_date": "2015-07-15",
      "total_funding": 11000000,
      "investor_first_invested_on": "2015-07-15"
    }
  ],
  "meta": {
    "total_record_count": 605,
    "total_pages": 13,
    "current_page": 1,
    "per_page": 50
  }
}