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": "20130321", "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\/glidevideotexting\/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\/glideraisessevenfiguresum.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" } ]