Company Details

Overview

This endpoint allows you to retrieve the full details for a specific company in our database.

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

Sample Code

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

It’s preferred that you use the company id number to get company details whenever possible. This helps ensure that the results you get are authoritative. However if all you have is a company’s canonical domain you can make the same request like:

$ curl "https://api.mattermark.com/domains/glide.com/companies?key=[YOUR KEY]"

Example Response:

{
    "name": "Glide",
    "id" : "10533813",
    "description": "Founded in May 2012, Glide is the world's only instant video messaging app.",
    "website": "glide.com",
    "mattermark_score": "241",
    "employees": "71",
    "employees_month_ago": "68",
    "employees_6_months_ago": "32",
    "website_uniques": "13578",
    "mobile_downloads": "5281",
    "stage": "b",
    "total_funding": 20000000,
    "last_funding_amount": 20000000,
    "last_funding_date": "2013­03­21",
    "location": "Seattle",
    "city": "Seattle",
    "state": "WA",
    "zip": "98155",
    "country": "USA",
    "twitter_handle": "GlideApp",
    "facebook_handle": "glideme",
    "linkedin_id": 3020582,
    "added_date": "2013-04-04 15:57:52",
    "revenue_range":"$5M - $10M",
    "itunes_apps": [{
        "developer_url": "http:\/\/www.glide.me\/",
        "itunes_id": "588199307",
        "itunes_url": "https:\/\/itunes.apple.com\/us\/app\/glide­video­texting\/id588199307?mt=8&uo=2",
        "app_name": "Glide ­ Video Texting"
    }],
        "google_play_apps": [{
                "id": 319510,
        "app_name": "Glide - Video Chat Messenger",
        "package_id": "com.glidetalk.glideapp",
        "company_id": 113022,
        "company_name": "Glide",
        "company_domain": "glide.me",
        "play_url": "http://play.google.com/store/apps/details?id=com.glidetalk.glideapp"
    }],
    "funding": [{
        "amount": 0,
        "currency": "USD",
        "series": "seed",
        "funding_date": "2013-03-21",
        "news_url": "http:\/\/www.finsmes.com\/2013\/03\/glide­raises­seven­figure­sum.html",
        "source": "derived",
        "investor_ids": [11722,11732],
        "investors": "Orey Gilliam,Philippe Schwartz"
    }],
    "acquired_by":[{
        "event_id":15,
        "closed_date":"2012-12-20",
        "company_id":1255,
        "company_name":"Oracle Corporation",
        "company_domain":"oracle.com"
    }],
    "acquired_companies":[{
        "event_id":10957519,
        "closed_date":"2017-04-20",
        "company_id":61444,
        "company_name":"Moat",
        "company_domain":"moat.com"
    }],
    "est_founding_date":"1999-01-01",
    "business_models":["B2B"],
    "industries":["data storage","enterprise software","hardware","information security","network / hosting / infrastructure","security","storage"],
    "stories":[{
        "title":"Israeli Glide introduces fast capture video and chat for Apple Watch",
        "url":"http://www.geektime.com/2016/11/13/israeli-glide-introduces-fast-capture-video-and-chat-for-apple-watch/",
        "date":"Nov 13 2016","source":"Geek Time"
    }],
    "growth_scores": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "210"
        },
        {
            "recorded_at": "2014-08-01 00:00:00 UTC",
            "score": "­87"
        }
    ],
    "mindshare_scores": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "210"
        },
        {
            "recorded_at": "2014-08-01 00:00:00 UTC",
            "score": "­87"
        }
    ],
    "employee_count": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "16"
        },
        {
            "recorded_at": "2014-07-02 00:00:00 UTC",
            "score": "17"
        }
    ],
    "alexa_rank": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "126653"
        },
        {
            "recorded_at": "2014-07-20 00:00:00 UTC",
            "score": "125531"
        }
    ],
    "facebook_talking_count": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "3894"
        },
        {
            "recorded_at": "2014-07-09 00:00:00 UTC",
            "score": "3816"
        }
    ],
    "facebook_like_count": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "168940"
        },
        {
            "recorded_at": "2014-07-09 00:00:00 UTC",
            "score": "166410"
        }
    ],
    "twitter_follower_count": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "10388"
        },
        {
            "recorded_at": "2014-07-19 00:00:00 UTC",
            "score": "10172"
        }
    ],
    "twitter_mentions": [],
    "linkedin_follower_count": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "46"
        },
        {
            "recorded_at": "2014-07-25 00:00:00 UTC",
            "score": "46"
        }
    ],
    "itunes_usa_weekly_downloads": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "49745"
        },
        {
            "recorded_at": "2014-08-01 00:00:00 UTC",
            "score": "56202"
        }
    ],
    "inbound_links": [
        {
            "recorded_at": "2014-08-09 00:00:00 UTC",
            "score": "123"
        },
        {
            "recorded_at": "2014-07-29 00:00:00 UTC",
            "score": "1025"
        }
    ],
    "est_monthly_uniques": [
        {
            "recorded_at": "2015-10-17 04:31:27 +0000",
            "score": "21543"
        },
        {
            "recorded_at": "2015-10-12 10:26:18 +0000",
            "score": "23477"
        }
    ]
}

Note that twitter_mentions is deprecated. An empty list [] is used in the response to maintain existing client compatibility.

News

The company news endpoint returns the fifty latest news articles about the specified company.

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

Example Request

$ curl "https://api.mattermark.com/companies/74910/stories?key=[YOUR KEY]"

Example Response

[
  {
      "id": 1426837,
      "title": "E-commerce roundup: Amazon India, Bata, FoodPanda & Snapdeal",
      "url": "http://feedproxy.google.com/~r/medianama/~3/pScV966Eya8/",
      "published_at": "2014-12-18 01:16:25 UTC",
      "source_title": "MediaNama"
  },
  {
      "id": 1426725,
      "title": "Snapdeal.com partners with Hero MotoCorp to sell two-wheelers through its platform",
      "url": "http://techcircle.vccircle.com/2014/12/18/snapdeal-com-partners-with-hero-motocorp-to-sell-two-wheelers-through-its-platform/",
      "published_at": "2014-12-18 00:33:16 UTC",
      "source_title": "Tech Circle VC Circle"
  }
]

Similar Companies

The similar companies endpoint returns up to 20 of the most similar companies ordered related to the specified company.

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

Example Request

To find companies that are similar to SnapDeal you could issue the following example request:

$ curl "https://api.mattermark.com/companies/74910/similar?key=[YOUR KEY]"

Example Response

[
    {
        "company_name": "Flipkart",
        "description": "Flipkart is an online shopping destination for electronics, books, music and movies.",
        "description_plain_text": "Flipkart is an online shopping destination for electronics, books, music and movies.",
        "domain": "flipkart.com",
        "id": 39279,
        "probability": 1.0,
        "stage": "h",
        "total_funding": 3051140000
    },
    {
        "company_name": "Junglee",
        "description": "Product Comparison Shopping",
        "description_plain_text": "Product Comparison Shopping",
        "domain": "junglee.com",
        "id": 30974,
        "probability": 0.6617908477783203,
        "stage": "exited (acquired)",
        "total_funding": null
    },
    {
        "company_name": "Gadgets ",
        "description": "No description available.",
        "description_plain_text": "No description available.",
        "domain": "gadgets.in",
        "id": 205107,
        "probability": 0.6479290723800659,
        "stage": "no known funding",
        "total_funding": null
    },
    {
        "company_name": "Grabmore",
        "description": "India Online Shopping Store",
        "description_plain_text": "India Online Shopping Store",
        "domain": "grabmore.in",
        "id": 96259,
        "probability": 0.6385279297828674,
        "stage": "no known funding",
        "total_funding": null
    },
    {
        "company_name": "Govasool",
        "description": "Online shopping website",
        "description_plain_text": "Online shopping website",
        "domain": "govasool.com",
        "id": 91388,
        "probability": 0.628568708896637,
        "stage": "no known funding",
        "total_funding": null
    }
]

Personnel

This endpoint allows you to retrieve key personnel for a specific company in our database.

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

Example Request

$ curl "https://api.mattermark.com/companies/143115/people?key=[YOUR KEY]"

Example Response:

[
    {
        "name": "Ari Roisman",
        "title": "Co-Founder / CEO",
        "path": "https://il.linkedin.com/in/aroisman"
    },
    {
        "name": "Jonathan Caras",
        "title": "Co-Founder / CTO",
        "path": "https://il.linkedin.com/in/jonathancaras"
    }
]

Contact Details

This endpoint allows you to retrieve an email address for a specific person in our database.

GET https://api.mattermark.com/companies/:company_id/contact?full_name=:full_name

Example Request

$ curl "https://api.mattermark.com/companies/146589/contact?full_name=Danielle%20Morrill"
  -H "Authorization: Bearer [YOUR KEY]"

Example Response

{
   "company_id" : 146589,
   "name" : "Danielle Morrill",
   "email" : "danielle@mattermark.com"
}

A null email indicates that contact information is unavailable.

Contact Request Rate Limiting

If our contact request infrastructure becomes overloaded, we may return a 400 response code. Please try again later.

Technology Stack

This endpoint allows you to retrieve the technology stack being used by a company.

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

Example Request

$ curl "https://api.mattermark.com/companies/146589/tech_stack"
  -H "Authorization: Bearer [YOUR KEY]"

Example Response

[
    {
        "company_id": 146589,
        "title": "Apache"
    },
    {
        "company_id": 146589,
        "title": "nginx"
    },
    {
        "company_id": 146589,
        "title": "Sendgrid"
    },
    {
        "company_id": 146589,
        "title": "Google Apps for Business"
    }
]