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

Supports Result Paging
Trial Access Available

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¶

$ 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