NAV

Language Selector:

shell ruby

Mattermark Republishing API

Introduction

The Mattermark Republishing API provides a detailed summary of information about each of the companies in the Mattermark database. This data is similar but not identical to what is available on our company profile pages. A full list of data returned is detailed in the Company Details subheading.

We’ve provided some easy to get started example code in the dark area along the right hand side of the page. Examples are displayed for use with Curl and Ruby! (You can switch the programming language of the examples with the tabs in the top right.)

API Differences

The Mattermark Republishing API is a different endpoint than the Mattermark Enterprise API. Compared to the Enterprise API, the Republishing API differs in two key ways.

  1. The Republishing API does not provide any historical data. For specific data points (such as employee count) it will provide the most recently recorded value, but does not include the historical data as one would get with the Enterprise API.
  2. The Republishing API returns a subset of fields for a specific company when compared to the fields returned by the Enterprise API for the same company.
  3. Company details are accessed via their base domain in the Republishing API.

Base URL

All URLs referenced in the documentation have the following base:

https://repub.mattermark.com/

SSL/HTTPS

The Mattermark API is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.

Examples

Throughout this document we provide you with inline examples of how to perform the requests to our API. Feel free to copy and paste these examples and use them in your own application. You can switch which language you’d like to see the examples in by using the “language selector” located at the top right of the page.

The shell examples should work on most modern operating systems. Mac and Linux users typically have cURL pre-installed for them. Windows users will likely need to follow the cURL install instructions.

The ruby examples make use of the “HTTParty” ruby gem.

Getting Started

Authentication

In order to make calls to our API you need to include your API key in the Authorization header of the request. The Authorization header value should be formatted as:

bearer [YOUR KEY]

If you are interested in obtaining an API key, contact sales@mattermark.com.

It is very important to store your API key in a private and secure location. Sharing your API key is strictly prohibited.

Example Request

Below is an example for accessing the company details for mattermark.com with the token included in the Authorization header:

$ curl -H "Authorization:bearer [YOUR KEY]" "https://repub.mattermark.com/companies?domain=mattermark.com"
require 'httparty'
response = HTTParty.get("https://repub.mattermark.com/companies?domain=mattermark.com", headers: { "Authorization" => "bearer [YOUR KEY]" })

Quotas

In some cases, an account may be assigned a quota for republishing API usage. Quota usage will be reported in the X-Quota-Consumed header for any Republishing API request. Exceeding your quota will not prevent access to the API, but may incur additional billing charges depending on the terms of your contract. See the Account endpoint for more details about quota reporting.

Rate Limiting

In order to assure high quality of service to all our customers our API enforces rate limiting rules of 1000 requests per 15 minutes. If you have exceeded your account’s rate limit we will return a 429 status code. Rate limit information is available in the X-RateLimit-* headers.

Company Details

This endpoint allows you to retrieve the summary details for a specific company in our database. Unlike the Enterprise API, companies are accessed by their root domain (ex: mattermark.com) instead of a company ID. If no company is found for an existing domain, the Republishing API will return a 404 error code.

Fields

Objects returned by the /companies endpoint will include the following fields:

Example

HTTP Request

GET https://repub.mattermark.com/companies?domain=:domain

Sample Code

$ curl -H "Authorization:bearer [YOUR KEY]" "https://repub.mattermark.com/companies?domain=mattermark.com"
require 'httparty'
response = HTTParty.get("https://repub.mattermark.com/companies?domain=mattermark.com", headers: { "Authorization" => "bearer [YOUR KEY]" })

Example Response:

{
  "name": "Mattermark",
  "description": "Mattermark is on a mission to organize the world's business information. We help dealmakers identify valuable opportunities to do business, with deal intelligence.",
  "industries": [
    "analytics",
    "consulting and research",
    "enterprise software",
    "finance",
    "machine learning",
    "market research",
    "search"
  ],
  "website": "mattermark.com",
  "location": "bay area",
  "city": "San Francisco",
  "state": "CA",
  "country": "usa",
  "est_founding_date": "2013-06-01",
  "stage": "b",
  "last_funding_date": "2016-03-20",
  "acquired_companies": [
    {
      "event_id": 10946719,
      "closed_date": "2014-09-22",
      "company_id": 53788,
      "company_name": "StartupList",
      "company_domain": "startupli.st"
    },
    {
      "event_id": 7880,
      "closed_date": "2013-02-20",
      "company_id": 80984,
      "company_name": "LaunchGram",
      "company_domain": "launchgram.com"
    }
  ],
  "twitter_handle": "mattermark",
  "facebook_handle": "mattermark",
  "linkedin_id": "3182754",
  "business_models": [
    "b2b",
    "saas"
  ],
  "employee_count": 65,
  "est_monthly_uniques": 335045,
  "twitter_follower_count": 26032,
  "facebook_like_count": 3792,
  "facebook_talking_count": 548,
  "linkedin_follower_count": 2585,
  "total_funding": 18300000,
  "last_funding_amount": 7300000,
  "mattermark_score": 580,
  "stories": [
    {
      "title": "Going Against the Flow: Danielle Morrill, CEO of Mattermark",
      "url": "http://www.huffingtonpost.com/charu-sharma/going-against-the-flow-da_b_10200700.html?utm_hp_ref=technology&ir=Technology",
      "date": "2016-05-29",
      "source": "Huffington Post / Technology"
    },
    {
      "title": "Mattermark Raises $7.3M in Series B Funding Round",
      "url": "http://www.finsmes.com/2016/03/mattermark-raises-7-3m-in-series-b-funding-round.html",
      "date": "2016-03-21",
      "source": "FinSMEs"
    },
    {
      "title": "Mattermark Picks Up $7.3M For Sales Leads",
      "url": "http://www.silicontap.com/mattermark_picks_up_7_3m_for_sales_leads/s-0064521.html",
      "date": "2016-03-21",
      "source": "Silicon Tap"
    },
    {
      "title": "Mattermark raises $7.3M at a $42M valuation to expand its B2B search and analytics tools",
      "url": "http://feedproxy.google.com/~r/Techcrunch/~3/CU1h5O1mJMU/",
      "date": "2016-03-20",
      "source": "Techcrunch"
    },
    {
      "title": "Sales research startup Mattermark raises $7.3 million, now valued at $42 million",
      "url": "http://venturebeat.com/2016/03/20/sales-research-startup-mattermark-raises-7-3-million-now-valued-at-42-million/",
      "date": "2016-03-20",
      "source": "VentureBeat"
    }
  ],
  "funding": [
    {
      "amount": 0,
      "currency": "",
      "series": "",
      "funding_date": null,
      "news_url": "",
      "source": "derived",
      "investor_ids": [
        13505,
        16778,
        18210,
        21683,
        23057
      ],
      "investors": [
        "Y Combinator",
        "SierraMaya360",
        "Pejman Mar Ventures",
        "Manyam Mallela",
        "Mihir Bhanot"
      ]
    },
    {
      "amount": 120000,
      "currency": "USD",
      "series": "seed",
      "funding_date": "2012-08-01",
      "news_url": "",
      "source": "derived",
      "investor_ids": [
        13505
      ],
      "investors": [
        "Y Combinator"
      ]
    },
    {
      "amount": 1000000,
      "currency": "USD",
      "series": "seed",
      "funding_date": "2012-10-15",
      "news_url": "http://techcrunch.com/2012/10/15/referly-1m/",
      "source": "derived",
      "investor_ids": [
        36,
        74,
        1461,
        1477,
        6676,
        7195,
        10613,
        10614,
        10615,
        10616,
        16204
      ],
      "investors": [
        "Ignition Partners",
        "New Enterprise Associates",
        "Eileen Burbidge",
        "500 Startups",
        "Michael Liou",
        "Ullas Naik",
        "Carter Rabasa",
        "Matt Monahan",
        "Damien Tanner",
        "Elliot Loh",
        "Jeff Lawson"
      ]
    },
    {
      "amount": 2650000,
      "currency": "USD",
      "series": "seed",
      "funding_date": "2014-06-29",
      "news_url": "",
      "source": "derived",
      "investor_ids": [
        62,
        135,
        858,
        2575,
        6800,
        7195,
        7940,
        8160,
        9918,
        9919,
        10052,
        16778,
        18210,
        18328,
        20688,
        21244,
        25075,
        25341
      ],
      "investors": [
        "Flybridge Capital Partners",
        "Felicis Ventures",
        "Andreessen Horowitz",
        "Great Oaks Venture Capital",
        "Armando Biondi",
        "Ullas Naik",
        "Slow Ventures",
        "Version One Ventures",
        "Greg Arrese",
        "Trent Gegax",
        "Naveen Selvadurai",
        "SierraMaya360",
        "Pejman Mar Ventures",
        "Gramercy Fund",
        "Switch VC",
        "Steve Loughlin",
        "Extreme Venture Partners",
        "Enrico Pandian"
      ]
    },
    {
      "amount": 730000,
      "currency": "USD",
      "series": "seed",
      "funding_date": "2014-09-05",
      "news_url": "",
      "source": "derived",
      "investor_ids": [
        19650
      ],
      "investors": [
        "FG Angels"
      ]
    },
    {
      "amount": 6500000,
      "currency": "USD",
      "series": "a",
      "funding_date": "2014-12-16",
      "news_url": "http://venturebeat.com/2014/12/16/mattermark-the-startup-helping-investors-rank-other-startups-picks-up-6-5m/",
      "source": "derived",
      "investor_ids": [
        38
      ],
      "investors": [
        "Foundry Group"
      ]
    },
    {
      "amount": 7300000,
      "currency": "USD",
      "series": "b",
      "funding_date": "2016-03-20",
      "news_url": "http://venturebeat.com/2016/03/20/sales-research-startup-mattermark-raises-7-3-million-now-valued-at-42-million/",
      "source": "derived",
      "investor_ids": [
        38,
        23934
      ],
      "investors": [
        "Foundry Group",
        "Jon Hallett"
      ]
    }
  ]
}

Account Details

The /account endpoint provides details about your account and quota usage. Accessing /account will not increment your consumed quota, but does require a valid API key and is subject to rate limiting. It is also a useful way to validate your API key.

The response object will be a JSON blob with the following fields:

Example

HTTP Request

GET https://repub.mattermark.com/account

Sample Code

$ curl -H "Authorization:bearer [YOUR KEY]" "https://repub.mattermark.com/account"
require 'httparty'
response = HTTParty.get("https://repub.mattermark.com/account, headers: { "Authorization" => "bearer [YOUR KEY]" })

Example Response:

{
    "qouta_consumed": 500,
    "quota_allocated": 100000
}

Response Codes and Errors

The Mattermark API will send responses back to your requests using one of the following HTTP codes:

Response Code Meaning
200 Ok – Everything worked great!
400 Bad Request – Your request was not properly sent.
403 Unauthorized – Your API key is wrong, is no longer valid, or you do not have access to the given resource.
404 Not Found – The specified endpoint could not be found
429 Rate Limit Exceeded – You have temporarily exceeded your rate limit. Refer to Rate Limits for more details.
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – We’re temporarily offline for maintenance. Please try again later.