Companies List

The companies endpoint allows you to retrieve a list of companies.

Below is a descriptive list of all the different ways in which you can query this endpoint to segment our growing database of companies. At the very bottom of this section you’ll find an example response along with a full table of all the query parameters outlined below.

HTTP Request

GET https://api.mattermark.com/companies

Example Response

{
    "meta": {
        "total_record_count": 149,
        "total_pages": 3,
        "current_page": 1,
        "per_page": 50
    },
    "companies": [
        {
            "company_name": "Blue Smoke LLC",
            "domain": "bluesmokellc.net",
            "id": "10808576",
            "url": "https://api.mattermark.com/companies/10808576"
        }
    ]
}

Business Name

Business Name

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&company_name=facebook"

Website URL

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&domain=facebook.com"

Industry & Business Model

Business Model Tags

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&business_models=B2B"

Industry Tags

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&industries=Analytics|Finance"

Keywords

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&keywords=Advertising|Analytics"

Geographical Location

State

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&state=CA|NY"

Country

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&country=USA|CAN"

Funding History

All Investors

The value you use to search by in this request is the mm_slug value for the investor. You can get the mm_slug value for any investor in our index by using the Investors endpoint.

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&investors=406-ventures"

Lifetime Total Funding

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&total_funding=1000000~10000000"

Last Funding Round Date

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&last_funding_date=raised in past 9 months"

Last Funding Round Amount

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&last_funding_amount=100000~"

Investment Stage

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&stage=No%20Known%20Funding"
# Can be one of the following 'No Known Funding', 'Pre Series A', 'a', 'b', 'c', 'Late', 'Exited'

Employee Count

Employee Count 1 Month Ago

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&employees_month_ago=500~"

Employees Added in Past Month

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&employees_added_in_month=40~50"

Employee Count Month-Over-Month Growth Rate

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&employees_mom=10~"

Unique Website Visitors

Unique Website Visitors Last Week

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&cached_uniques_week_ago=1000~"

Unique Website Visitors Week-Over-Week Growth Rate

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&uniques_wow=1000~"

Unique Website Visitors One Month Ago

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&cached_uniques_month_ago=6000~"

Unique Website Visitors Month-Over-Month Growth Rate

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&uniques_mom=1000~"

Mobile Downloads

Has Mobile App

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&has_mobile=1"

Mobile Downloads Last Week

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&cached_mobile_downloads_week_ago=10000~"

Mobile Downloads Week-Over-Week Growth Rate

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&mobile_downloads_wow=5000~"

Mobile Downloads One Month Ago

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&cached_mobile_downloads_month_ago=500000~"

Mobile Downloads Month-Over-Month Growth Rate

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&mobile_downloads_mom=500~"

Traction Scores

Mindshare Score

$ curl "https://api.mattermark.com/companies/?key=[YOUR KEY]&mattermark_score=10000~50000"

All Query Parameters

For parameters with the “list” format, you can “OR” together different options with the pipe (|) operator.

A query to search for companies in either Series A or Series would be GET https://api.mattermark.com/companies?key=[YOUR KEY]&stage=a|b

Parameter Format Example Description
domain string facebook.com The domain of the company’s website.
company_name string Facebook The company’s name.
added_date date_range 2017-03-20~2017-04-19 The date the company started being tracked by Mattermark.
mattermark_score numeric_range 1000~ The current Mattermark score of the company.
momentum_score numeric_range ~­-1000 The latest weekly momentum score of the company.
employees numeric range 5~25 The number of employees currently at the company.
employees_month_ago numeric range 5~20 Count of employees one month ago
employees_added_in_month numeric range 5~ Count of employees added this month.
employees_mom numeric range 1~20 The percent employee growth during that month.
cached_uniques numeric range 100000~ The estimated monthly unique visitors to the company’s website.
cached_uniques_week_ago numeric range 100000~ The estimated monthly unique visitors to the company’s website during the past 7 days.
uniques_wow numeric range 5~25 The percent change in the estimated monthly unique visitors to the company’s website in the past 7 days.
cached_uniques_month_ago numeric range 100000~ The estimated monthly unique visitors to the company’s website during the past month.
uniques_mom numeric range 5~25 The percent change in the estimated monthly unique visitors to the company’s website in the past month.
cached_mobile_downloads numeric range 1~ The estimated monthly mobile downloads from the U.S. iTunes app store.
cached_mobile_downloads_week_ago numeric range 10000~ The estimated monthly mobile downloads one week ago from the U.S. iTunes app store.
mobile_downloads_wow numeric range 5~25 The change in the estimated monthly mobile downloads from the U.S. iTunes app store during the past week.
cached_mobile_downloads_month_ago numeric range 10000~ The count of the estimated monthly mobile downloads from the U.S. iTunes app store during the past month.
mobile_downloads_mom string numeric range 5~25
est_founding_date string One of the following:
within 3 months
within 6 months
within 9 months
within 1 year
within 2 years
within 3 years
within 5 years
within 10 years
The estimated founding date of the company.
stage list One or several of the following:
Unknown
No Known Funding
Pre Series A
a
b
c

i
Late
Exited
The most recent funding round for the company.
investors string (mm_slug) See Investors to get a list of all investors. The names of the investors that have invested in the company.
total_funding numeric range 1000000~ The total publicly reported money raised by the company. Only includes money raised in U.S. Dollars. Other currencies are returned in detail response, but not included in this total.
last_funding_date string One of the following:
not in past 3 months
not in past 6 months
not in past 9 months
not in past year
not in past 13 months
not in past 16 months
not in past 18 months
not in past 2 years
never raised
raised in past 3 months
raised in past 6 months
raised in past 9 months
raised in past year
raised in past 2 years
has ever raised
Date of last funding event.
last_funding_amount numeric range 10000000~ The amount of funding investment in the the most recent funding event
location list Bay Area New York
state list CA State (location in the US) of the company’s headquarters. For a complete list of locations contact support@mattermark.com)
has_mobile 0 or 1 1 Only include (1) or exclude (0) companies that have a mobile application.
has_google_play 0 or 1 1 Only include (1) or exclude (0) companies that have a Google Play application.
has_itunes 0 or 1 1 Only include (1) or exclude (0) companies that have an iTunes application.
play_category list media_and_video The Google Play store categories of applications associated with the company
itunes_category list food_and_drink The iTunes store categories of applications associated with the company
business_models list B2B The business models employed by the company to generate revenue.
industries list Analytics The industries the company operates within.
keywords list Advertising Keywords associated with the company.
country list USA GBR