{"_id":"55c53c115c5d9f0d004969b2","link_external":false,"link_url":"","__v":6,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"","auth":"required","params":[]},"category":"55c53c105c5d9f0d004969b0","createdAt":"2015-08-07T23:15:29.130Z","githubsync":"","slug":"getting-started","sync_unique":"","type":"basic","updates":[],"body":"Welcome to the StackShare API (Closed Beta)! We're excited to start giving people access to the data on StackShare. Our API has two main sets of endpoints: Tools and Stacks. Tools are defined as languages, frameworks, cloud infrastructure, business services, and open source projects (e.g. Heroku, Google Analytics, Rails, etc). Stacks are collections of tools that belong to a company (e.g. Instacart's stack includes Amazon EC2, React, Python).\n\nTo request access to the StackShare API just sign up [here](https://api.stackshare.io/).\n\nPlease abide by the [StackShare API Terms](https://api.stackshare.io/terms).\n\nEmail us with any questions or concerns at [api@stackshare.io](mailto:api@stackshare.io)","title":"Getting Started with StackShare API","user":"55c53bcf52a1ca0d00b1197b","excerpt":"This page will help you get started with StackShare API. You'll be up and running in a jiffy!","hidden":false,"project":"55c53c0e5c5d9f0d004969ac","version":"55c53c0f5c5d9f0d004969af","isReference":false,"order":0,"childrenPages":[]}

Getting Started with StackShare API

This page will help you get started with StackShare API. You'll be up and running in a jiffy!

Welcome to the StackShare API (Closed Beta)! We're excited to start giving people access to the data on StackShare. Our API has two main sets of endpoints: Tools and Stacks. Tools are defined as languages, frameworks, cloud infrastructure, business services, and open source projects (e.g. Heroku, Google Analytics, Rails, etc). Stacks are collections of tools that belong to a company (e.g. Instacart's stack includes Amazon EC2, React, Python). To request access to the StackShare API just sign up [here](https://api.stackshare.io/). Please abide by the [StackShare API Terms](https://api.stackshare.io/terms). Email us with any questions or concerns at [api@stackshare.io](mailto:api@stackshare.io)
Welcome to the StackShare API (Closed Beta)! We're excited to start giving people access to the data on StackShare. Our API has two main sets of endpoints: Tools and Stacks. Tools are defined as languages, frameworks, cloud infrastructure, business services, and open source projects (e.g. Heroku, Google Analytics, Rails, etc). Stacks are collections of tools that belong to a company (e.g. Instacart's stack includes Amazon EC2, React, Python). To request access to the StackShare API just sign up [here](https://api.stackshare.io/). Please abide by the [StackShare API Terms](https://api.stackshare.io/terms). Email us with any questions or concerns at [api@stackshare.io](mailto:api@stackshare.io)
{"_id":"55df830e437b3f0d004ba20d","__v":12,"hidden":false,"user":"55c5401352a1ca0d00b1197f","slug":"stacksid","title":"/stacks/:id","updates":[],"body":"","excerpt":"Get stacks by specifying the id of the stack","githubsync":"","isReference":false,"link_url":"","editedParams":true,"order":0,"project":"55c53c0e5c5d9f0d004969ac","sync_unique":"","type":"get","version":"55c53c0f5c5d9f0d004969af","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/v1/stacks/:id","auth":"required","examples":{"codes":[{"language":"json","code":"{  \n   id:412,\n   name:\"StackShare\",\n   slug:\"stackshare\",\n   tools:[\n      {  \n         id:2538,\n         name:\"HTML5\",\n         canonical_url:\"http://stackshare.io/html5\",\n         image_url:\"http://img.stackshare.io/service/2538/kEpgHiC9.png\"\n      },\n      {  \n         id:1078,\n         name:\"Sidekiq\",\n         canonical_url:\"http://stackshare.io/sidekiq\",\n         image_url:\"http://img.stackshare.io/service/1078/4b7277462dadad85454ab427ce3f0ca7.png\"\n      },\n      {  \n         id:1020,\n         name:\"React\",\n         canonical_url:\"http://stackshare.io/react\",\n         image_url:\"http://img.stackshare.io/service/1020/OYIaJ1KK.png\"\n      },\n      {  \n         id:4601,\n         name:\"Heroku Redis\",\n         canonical_url:\"http://stackshare.io/heroku-redis\",\n         image_url:\"http://img.stackshare.io/service/4601/original.png\"\n      },\n      {  \n         id:1031,\n         name:\"Redis\",\n         canonical_url:\"http://stackshare.io/redis\",\n         image_url:\"http://img.stackshare.io/service/1031/redis.png\"\n      },\n      {  \n         id:1617,\n         name:\"Uptime Robot\",\n         canonical_url:\"http://stackshare.io/uptime-robot\",\n         image_url:\"http://img.stackshare.io/company/4322/G22d2Q6n_400x400.png\"\n      },\n      {  \n         id:2643,\n         name:\"RuboCop\",\n         canonical_url:\"http://stackshare.io/rubocop\",\n         image_url:\"http://img.stackshare.io/service/2643/rubocop.png\"\n      },\n      {  \n         id:305,\n         name:\"Code Climate\",\n         canonical_url:\"http://stackshare.io/code-climate\",\n         image_url:\"http://img.stackshare.io/service/305/KFgYaUkK.png\"\n      },\n      {  \n         id:990,\n         name:\"Rails\",\n         canonical_url:\"http://stackshare.io/rails\",\n         image_url:\"http://img.stackshare.io/service/990/x57_Lorv.png\"\n      },\n      {  \n         id:224,\n         name:\"Codeship\",\n         canonical_url:\"http://stackshare.io/codeship\",\n         image_url:\"http://img.stackshare.io/service/224/UJzltHZA.png\"\n      }\n   ],\n   description:\"We help developers find the best tools and services.\",\n   twitter_username:\"stackshareio\",\n   verified:true,\n   community_generated:true,\n   popularity:4,\n   trending_score_for_today:5,\n   trending_score_for_week:76,\n   canonical_url:\"http://stackshare.io/stackshare/stackshare\",\n   stack_url:\"http://stackshare.io/\",\n   view_count:2861,\n   company:{  \n      id:1595,\n      name:\"StackShare\",\n      slug:\"stackshare\",\n      image_url:\"http://img.stackshare.io/company/1595/RTjlx-lY.png\",\n      description:\"We help developers find the best tools and services.\",\n      twitter_username:\"stackshareio\",\n      website_url:\"http://stackshare.io/\",\n      verified:true,\n      angellist_url:\"https://angel.co/stackshare\",\n      location:\"san francisco\",\n      canonical_url:\"http://stackshare.io/stackshare\"\n   },\n   tags:[  \n      {  \n         id:12,\n         name:\"reviews-and-recommendations\"\n      },\n      {  \n         id:13,\n         name:\"developer-tools\"\n      },\n      {  \n         id:2,\n         name:\"cloud-computing\"\n      }\n   ]\n}","name":""}]},"method":"get","params":[{"ref":"","required":false,"type":"int","in":"path","_id":"55e0ea8fd052580d0038c984","default":"required","desc":"Pass in the ID of a stack","name":"id"}]},"category":"55c5409252a1ca0d00b11983","createdAt":"2015-08-27T21:37:18.833Z","editedParams2":true,"link_external":false,"childrenPages":[]}

get/stacks/:id

Get stacks by specifying the id of the stack

Path Params

id:
integerrequired
Pass in the ID of a stack

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55c5427552a1ca0d00b11988","__v":7,"githubsync":"","link_external":false,"type":"get","user":"55c5401352a1ca0d00b1197f","category":"55c5409252a1ca0d00b11983","createdAt":"2015-08-07T23:42:45.482Z","excerpt":"Get stacks by specifying domain name for a company or a tag_id (only one is required)","hidden":false,"link_url":"","version":"55c53c0f5c5d9f0d004969af","editedParams":true,"isReference":false,"order":1,"project":"55c53c0e5c5d9f0d004969ac","sync_unique":"","title":"/stacks/lookup","updates":[],"api":{"auth":"required","examples":{"codes":[{"name":"","code":"{  \n   id:29,\n   name:\"Yelp\",\n   slug:\"yelp\",\n   tools:[  \n      {  \n         id:64,\n         name:\"Google Analytics\"\n      },\n      {  \n         id:247,\n         name:\"Google Apps\"\n      },\n      {  \n         id:71,\n         name:\"Desk.com\"\n      },\n      {  \n         id:264,\n         name:\"Crashlytics\"\n      },\n      {  \n         id:1390,\n         name:\"pre-commit by Yelp\"\n      }\n   ],\n   description:\"Yelp was founded in 2004 to help people find great local businesses like dentists, hair stylists and mechanics. Yelp had an average of approximately 102 million monthly unique visitors in Q1 2013. Yelpers have written over 39 million local reviews. In addition to reviews, you can use Yelp to find events, lists and to talk with other Yelpers.\",\n   twitter_username:\"Yelp\",\n   verified:false,\n   community_generated:true,\n   popularity:5,\n   trending_score_for_today:2,\n   trending_score_for_week:58,\n   canonical_url:\"http://stackshare.io/yelp/yelp\",\n   stack_url:\"http://www.yelp.com/\",\n   view_count:2729,\n   company:{  \n      id:396,\n      name:\"Yelp\",\n      slug:\"yelp\",\n      image_url:\"http://img.stackshare.io/company/396/JoD5bESQ.png\",\n      description:\"Yelp was founded in 2004 to help people find great local businesses like dentists, hair stylists and mechanics. Yelp had an average of approximately 102 million monthly unique visitors in Q1 2013. Yelpers have written over 39 million local reviews. In addition to reviews, you can use Yelp to find events, lists and to talk with other Yelpers.\",\n      twitter_username:\"Yelp\",\n      website_url:\"http://www.yelp.com/\",\n      verified:true,\n      angellist_url:\"https://angel.co/yelp\",\n      location:\"san francisco\",\n      canonical_url:\"http://stackshare.io/yelp\"\n   },\n   tags:[  \n      {  \n         id:81,\n         name:\"local-search\"\n      },\n      {  \n         id:79,\n         name:\"search\"\n      },\n      {  \n         id:12,\n         name:\"reviews-and-recommendations\"\n      },\n      {  \n         id:80,\n         name:\"local\"\n      }\n   ]\n}","language":"json"}]},"method":"get","params":[{"_id":"55df829f437b3f0d004ba20b","default":"optional","desc":"Only one filter maybe used in each request: tag_id can be retrieved using the /stacks/tags endpoint, check it for more details. Example: https://api.stackshare.io/v1/stacks/lookup?tag_id=12?&access_token=ACCESS_TOKEN","name":"tag_id","ref":"","required":false,"type":"int","in":"query"},{"_id":"55df8e57437b3f0d004ba23a","default":"optional","desc":"Only one filter maybe used in each request: the domain (do NOT include http://www) of the stack. Example: https://api.stackshare.io/v1/stacks/lookup?domain=airbnb.com?&access_token=ACCESS_TOKEN","name":"domain","ref":"","required":false,"type":"string","in":"query"}],"results":{"codes":[{"status":200,"language":"json","code":"{\n}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/v1/stacks/lookup"},"body":"[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"\",\n      \"language\": \"javascript\"\n    }\n  ]\n}\n[/block]","editedParams2":true,"slug":"testinput-1","childrenPages":[]}

get/stacks/lookup

Get stacks by specifying domain name for a company or a tag_id (only one is required)

Query Params

tag_id:
integeroptional
Only one filter maybe used in each request: tag_id can be retrieved using the /stacks/tags endpoint, check it for more details. Example: https://api.stackshare.io/v1/stacks/lookup?tag_id=12?&access_token=ACCESS_TOKEN
domain:
stringoptional
Only one filter maybe used in each request: the domain (do NOT include http://www) of the stack. Example: https://api.stackshare.io/v1/stacks/lookup?domain=airbnb.com?&access_token=ACCESS_TOKEN
[block:code] { "codes": [ { "code": "", "language": "javascript" } ] } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



[block:code] { "codes": [ { "code": "", "language": "javascript" } ] } [/block]
{"_id":"55df835b437b3f0d004ba20f","link_external":false,"link_url":"","user":"55c5401352a1ca0d00b1197f","__v":4,"category":"55c5409252a1ca0d00b11983","slug":"stackssearch","title":"/stacks/search","updates":[],"version":"55c53c0f5c5d9f0d004969af","editedParams2":true,"excerpt":"The search endpoint allows you to search by keyword and retrieve a maximum of 3 stacks most closely matched with your keyword.","githubsync":"","hidden":false,"order":2,"project":"55c53c0e5c5d9f0d004969ac","sync_unique":"","type":"get","api":{"url":"/v1/stacks/search","auth":"required","examples":{"codes":[{"language":"json","code":"{  \n   id:412,\n   name:\"StackShare\",\n   slug:\"stackshare\",\n   website_url:\"http://stackshare.io/\",\n   canonical_url:\"http://stackshare.io/stackshare/stackshare\"\n}","name":""}]},"method":"get","params":[{"required":false,"type":"string","in":"query","_id":"55df83acdd038c0d00e85e53","default":"required","desc":"This is the keyword you would like to search for. Example: https://api.stackshare.io/v1/stacks/search?q=stackshare?&access_token=ACCESS_TOKEN","name":"q"}],"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"name":"","status":400,"language":"json","code":"{}"}]},"settings":""},"body":"","createdAt":"2015-08-27T21:38:35.459Z","editedParams":true,"childrenPages":[]}

get/stacks/search

The search endpoint allows you to search by keyword and retrieve a maximum of 3 stacks most closely matched with your keyword.

Query Params

q:
stringrequired
This is the keyword you would like to search for. Example: https://api.stackshare.io/v1/stacks/search?q=stackshare?&access_token=ACCESS_TOKEN

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55df8404437b3f0d004ba215","category":"55c5409252a1ca0d00b11983","excerpt":"This is the most interesting endpoint as it will give you 50 random stacks every time. Come and explore the amazing stacks on StackShare.","updates":[],"__v":8,"link_external":false,"project":"55c53c0e5c5d9f0d004969ac","user":"55c5401352a1ca0d00b1197f","version":"55c53c0f5c5d9f0d004969af","githubsync":"","body":"","createdAt":"2015-08-27T21:41:24.409Z","link_url":"","order":3,"slug":"explore","sync_unique":"","type":"get","api":{"examples":{"codes":[{"language":"json","code":"{  \n   id:7480,\n   name:\"Shizzle\",\n   slug:\"shizzle\",\n   tools:[  \n      {  \n         id:1005,\n         name:\"Go\"\n      },\n      {  \n         id:996,\n         name:\"Spring\"\n      },\n      {  \n         id:997,\n         name:\"Groovy\"\n      },\n      {  \n         id:998,\n         name:\"Grails\"\n      },\n      {  \n         id:914,\n         name:\"Apache Mesos\"\n      },\n      {  \n         id:1885,\n         name:\"Kubernetes\"\n      }\n   ],\n   description:\"\",\n   twitter_username:null,\n   verified:true,\n   community_generated:false,\n   popularity:0,\n   trending_score_for_today:6,\n   trending_score_for_week:9,\n   canonical_url:\"http://stackshare.io/shizzle-labs/shizzle\",\n   stack_url:\"http://shizzle.co\",\n   view_count:16,\n   company:{  \n      id:4371,\n      name:\"Shizzle Labs\",\n      slug:\"shizzle-labs\",\n      image_url:\"https://pbs.twimg.com/profile_images/491232440644415488/ZzE1bjBX.png\",\n      description:\"\",\n      twitter_username:\"shizzleapp\",\n      website_url:\"http://shizzle.co\",\n      verified:false,\n      angellist_url:\"https://angel.co/shizzle\",\n      location:\"london\",\n      canonical_url:\"http://stackshare.io/shizzle-labs\"\n   },\n   tags:[  \n      {  \n         id:44,\n         name:\"e-commerce\"\n      },\n      {  \n         id:249,\n         name:\"video\"\n      }\n   ]\n}","name":""}]},"method":"get","params":[],"results":{"codes":[{"name":"","status":200,"language":"json","code":"{}"},{"language":"json","code":"{}","name":"","status":400}]},"settings":"","url":"/v1/stacks/explore","auth":"required"},"hidden":false,"title":"/stacks/explore","childrenPages":[]}

get/stacks/explore

This is the most interesting endpoint as it will give you 50 random stacks every time. Come and explore the amazing stacks on StackShare.


User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55df83b7437b3f0d004ba211","createdAt":"2015-08-27T21:40:07.145Z","editedParams":true,"link_url":"","sync_unique":"","version":"55c53c0f5c5d9f0d004969af","body":"","editedParams2":true,"slug":"stackstags","updates":[],"__v":7,"category":"55c5409252a1ca0d00b11983","githubsync":"","link_external":false,"project":"55c53c0e5c5d9f0d004969ac","type":"get","user":"55c5401352a1ca0d00b1197f","api":{"results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/v1/stacks/tags","auth":"required","examples":{"codes":[{"name":"","language":"json","code":"[  \n   {  \n      id:21,\n      name:\"peer-to-peer\"\n   },\n   {  \n      id:22,\n      name:\"marketplaces\"\n   },\n   {  \n      id:23,\n      name:\"hotels\"\n   },\n   {  \n      id:24,\n      name:\"sms\"\n   }\n]"}]},"method":"get","params":[{"required":false,"type":"int","in":"query","_id":"55df8fbb4c870e0d00026c33","default":"optional","desc":"This is an optional page number for stack tags; first page will be given by default if page is absent. Example: https://api.stackshare.io/v1/stacks/tags?page=2&access_token=ACCESSTOKEN","name":"page"}]},"hidden":false,"order":4,"title":"/stacks/tags","excerpt":"The tags endpoint gives you a list of tags which you can use as filter for lookup (checkout the /stacks/lookup endpoint)","childrenPages":[]}

get/stacks/tags

The tags endpoint gives you a list of tags which you can use as filter for lookup (checkout the /stacks/lookup endpoint)

Query Params

page:
integeroptional
This is an optional page number for stack tags; first page will be given by default if page is absent. Example: https://api.stackshare.io/v1/stacks/tags?page=2&access_token=ACCESSTOKEN

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55df84bb437b3f0d004ba21a","link_url":"","order":0,"slug":"toolsid","title":"/tools/:id","user":"55c5401352a1ca0d00b1197f","version":"55c53c0f5c5d9f0d004969af","__v":3,"category":"55c540a15c5d9f0d004969b8","createdAt":"2015-08-27T21:44:27.305Z","editedParams2":true,"project":"55c53c0e5c5d9f0d004969ac","type":"get","updates":[],"excerpt":"","githubsync":"","link_external":false,"sync_unique":"","api":{"params":[{"default":"required","desc":"id of the tool you are retrieving. You can find tool id using the stacks endpoints. Example: https://api.stackshare.io/v1/tools/61?&access_token=ACCESSTOKEN","name":"id","required":false,"type":"string","in":"path","_id":"55df84fea50de10d00062f7f"}],"results":{"codes":[{"code":"{}","name":"","status":200,"language":"json"},{"name":"","status":400,"language":"json","code":"{}"}]},"settings":"","url":"/v1/tools/:id","auth":"required","examples":{"codes":[{"name":"","language":"json","code":"{  \n   id:133,\n   name:\"Heroku\",\n   company_stack_count:384,\n   personal_stack_count:382,\n   tag_line:\"Build, deliver, monitor and scale web apps and APIs with a trail blazing developer experience.\",\n   website_url:\"https://www.heroku.com\",\n   documentation_url:\"https://devcenter.heroku.com/\",\n   twitter_username:\"heroku\",\n   image_url:\"http://pbs.twimg.com/profile_images/464169564171821056/43sHKeth.png\",\n   description:\"Heroku is a cloud application platform – a new way of building and deploying web apps. Heroku lets app developers spend 100% of their time on their application code, not managing servers, deployment, ongoing operations, or scaling.\",\n   opensource_url:\"\",\n   features:\"Agile deployment for Ruby, Node.js, Clojure, Java, Python, Go and Scala.;Run and scale any type of app.;Total visibility across your entire app.;Erosion-resistant architecture. Rich control surfaces.\",\n   slug:\"heroku\",\n   popularity:1657,\n   layer:{  \n      id:1,\n      name:\"Application and Data\",\n      slug:\"application_and_data\"\n   },\n   category:{  \n      id:178,\n      name:\"Application Hosting\",\n      slug:\"application-hosting\",\n      canonical_url:\"http://stackshare.io/application-hosting\"\n   },\n   function:{  \n      id:44,\n      name:\"Platform as a Service\",\n      slug:\"platform-as-a-service\",\n      canonical_url:\"http://stackshare.io/platform-as-a-service\"\n   },\n   verified:true,\n   trending_score_for_today:3,\n   trending_score_for_week:290,\n   canonical_url:\"http://stackshare.io/heroku\",\n   total_vote_count:1873,\n   reasons:[  \n      {  \n         one_liner:\"Easy deployment\",\n         vote_count:378\n      },\n      {  \n         one_liner:\"Free for side projects\",\n         vote_count:237\n      },\n      {  \n         one_liner:\"Simple scaling\",\n         vote_count:206\n      },\n      {  \n         one_liner:\"Huge time-saver\",\n         vote_count:183\n      },\n      {  \n         one_liner:\"Low devops skills required\",\n         vote_count:139\n      },\n      {  \n         one_liner:\"Add-ons for almost everything\",\n         vote_count:125\n      },\n      {  \n         one_liner:\"Easy Setup\",\n         vote_count:121\n      },\n      {  \n         one_liner:\"Better for Startups\",\n         vote_count:112\n      },\n      {  \n         one_liner:\"Beginner friendly\",\n         vote_count:94\n      },\n      {  \n         one_liner:\"Low learning curve\",\n         vote_count:82\n      }\n   ]\n}"}]},"method":"get"},"body":"","editedParams":true,"hidden":false,"childrenPages":[]}

get/tools/:id


Path Params

id:
stringrequired
id of the tool you are retrieving. You can find tool id using the stacks endpoints. Example: https://api.stackshare.io/v1/tools/61?&access_token=ACCESSTOKEN

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55dfe7e13d8bfd0d00c65dcb","api":{"params":[{"in":"query","_id":"55dfe80e6dd2da0d0040416c","default":"","desc":"ID of the grouping you'd like tools results for. Example: https://api.stackshare.io/v1/tools/lookup?layer_id=1&access_token=ACCESSTOKEN","name":"layer_id","required":false,"type":"int"},{"required":false,"type":"int","in":"query","_id":"55dfe80e6dd2da0d0040416b","default":"","desc":"ID of the grouping you'd like tools results for. Example: https://api.stackshare.io/v1/tools/lookup?category_id=186&access_token=ACCESSTOKEN","name":"category_id"},{"_id":"55dfe80e6dd2da0d0040416a","default":"","desc":"ID of the grouping you'd like tools results for. Example: https://api.stackshare.io/v1/tools/lookup?function_id=33&access_token=ACESSTOKEN","name":"function_id","required":false,"type":"int","in":"query"}],"results":{"codes":[{"code":"{}","name":"","status":200,"language":"json"},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/v1/tools/lookup","auth":"required","examples":{"codes":[{"language":"json","code":"{  \n   id:25,\n   name:\"Amazon S3\",\n   company_stack_count:600,\n   personal_stack_count:270,\n   tag_line:\"Store and retrieve any amount of data, at any time, from anywhere on the web\",\n   website_url:\"http://aws.amazon.com/s3\",\n   documentation_url:\"http://aws.amazon.com/documentation/\",\n   twitter_username:\"\",\n   image_url:\"http://img.stackshare.io/service/25/amazon-s3.png\",\n   description:\"Amazon Simple Storage Service provides a fully redundant data storage infrastructure for storing and retrieving any amount of data, at any time, from anywhere on the web\",\n   opensource_url:\"\",\n   features:\"Write, read, and delete objects...\",\n   slug:\"amazon-s3\",\n   popularity:1623,\n   layer:{  \n      id:1,\n      name:\"Application and Data\",\n      slug:\"application_and_data\"\n   },\n   category:{  \n      id:186,\n      name:\"Data Stores\",\n      slug:\"data-stores\",\n      canonical_url:\"http://stackshare.io/data-stores\"\n   },\n   function:{  \n      id:10,\n      name:\"Cloud Storage\",\n      slug:\"cloud-storage\",\n      canonical_url:\"http://stackshare.io/cloud-storage\"\n   },\n   verified:false,\n   trending_score_for_today:1,\n   trending_score_for_week:54,\n   canonical_url:\"http://stackshare.io/amazon-s3\",\n   total_vote_count:864,\n   reasons:[  \n      {  \n         one_liner:\"Reliable\",\n         vote_count:231\n      },\n      {  \n         one_liner:\"Scalable\",\n         vote_count:192\n      },\n      {  \n         one_liner:\"Cheap\",\n         vote_count:189\n      },\n      {  \n         one_liner:\"Simple & Easy\",\n         vote_count:134\n      },\n      {  \n         one_liner:\"Many SDKs\",\n         vote_count:35\n      },\n      {  \n         one_liner:\"Scalable\",\n         vote_count:22\n      },\n      {  \n         one_liner:\"Logical\",\n         vote_count:19\n      },\n      {  \n         one_liner:\"Reliable\",\n         vote_count:16\n      },\n      {  \n         one_liner:\"Simple & Easy\",\n         vote_count:13\n      },\n      {  \n         one_liner:\"1000+ POPs\",\n         vote_count:7\n      }\n   ]\n}","name":""}]},"method":"get"},"link_external":false,"order":1,"version":"55c53c0f5c5d9f0d004969af","createdAt":"2015-08-28T04:47:29.575Z","hidden":false,"title":"/tools/lookup","type":"get","updates":[],"user":"55c5401352a1ca0d00b1197f","sync_unique":"","body":"","editedParams":true,"editedParams2":true,"githubsync":"","link_url":"","slug":"toolslookup","__v":3,"category":"55c540a15c5d9f0d004969b8","excerpt":"","project":"55c53c0e5c5d9f0d004969ac","childrenPages":[]}

get/tools/lookup


Query Params

layer_id:
integer
ID of the grouping you'd like tools results for. Example: https://api.stackshare.io/v1/tools/lookup?layer_id=1&access_token=ACCESSTOKEN
category_id:
integer
ID of the grouping you'd like tools results for. Example: https://api.stackshare.io/v1/tools/lookup?category_id=186&access_token=ACCESSTOKEN
function_id:
integer
ID of the grouping you'd like tools results for. Example: https://api.stackshare.io/v1/tools/lookup?function_id=33&access_token=ACESSTOKEN

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55df8509a50de10d00062f80","type":"get","link_external":false,"sync_unique":"","category":"55c540a15c5d9f0d004969b8","excerpt":"","githubsync":"","link_url":"","slug":"toolssearch","user":"55c5401352a1ca0d00b1197f","__v":5,"createdAt":"2015-08-27T21:45:45.085Z","hidden":false,"project":"55c53c0e5c5d9f0d004969ac","title":"/tools/search","updates":[],"version":"55c53c0f5c5d9f0d004969af","api":{"url":"/v1/tools/search","auth":"required","examples":{"codes":[{"language":"json","code":"[  \n   {  \n      id:637,\n      name:\"Amazon A/B Testing\",\n      slug:\"amazon-ab-testing\",\n      website_url:\"https://developer.amazon.com/public/apis/manage/ab-testing\",\n      canonical_url:\"http://stackshare.io/amazon-ab-testing\"\n   },\n   {  \n      id:434,\n      name:\"Amazon RDS for PostgreSQL\",\n      slug:\"amazon-rds-for-postgresql\",\n      website_url:\"http://aws.amazon.com/rds/postgresql/\",\n      canonical_url:\"http://stackshare.io/amazon-rds-for-postgresql\"\n   },\n   {  \n      id:433,\n      name:\"Amazon Kinesis\",\n      slug:\"amazon-kinesis\",\n      website_url:\"http://aws.amazon.com/kinesis/\",\n      canonical_url:\"http://stackshare.io/amazon-kinesis\"\n   }\n]","name":""}]},"method":"get","params":[{"_id":"55df8526437b3f0d004ba21d","default":"required","desc":"This is the keyword you would like to search for. Example: https://api.stackshare.io/v1/tools/search?q=amazon&access_token=ACCESSTOKEN","name":"q","required":false,"type":"string","in":"query"}],"results":{"codes":[{"name":"","status":200,"language":"json","code":"{}"},{"status":400,"language":"json","code":"{}","name":""}]},"settings":""},"body":"","order":2,"editedParams":true,"editedParams2":true,"childrenPages":[]}

get/tools/search


Query Params

q:
stringrequired
This is the keyword you would like to search for. Example: https://api.stackshare.io/v1/tools/search?q=amazon&access_token=ACCESSTOKEN

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55df8543dd038c0d00e85e58","api":{"examples":{"codes":[{"name":"","language":"json","code":"{  \n   id:1454,\n   name:\"RubyMine\",\n   company_stack_count:42,\n   personal_stack_count:54,\n   tag_line:\"The Most Intelligent Ruby and Rails IDE\",\n   website_url:\"http://www.jetbrains.com/ruby/\",\n   documentation_url:\"http://www.jetbrains.com/ruby/documentation/\",\n   twitter_username:\"rubymine\",\n   image_url:\"http://img.stackshare.io/service/1454/H6px0sRn.png\",\n   description:\"JetBrains RubyMine IDE provides a comprehensive Ruby code editor aware of dynamic language specifics and delivers smart coding assistance, intelligent code refactoring and code analysis capabilities. \",\n   opensource_url:\"\",\n   features:\"Intelligent Ruby Editor;On-the-fly code analysis;Rails Models Diagram, Rails Project View;RSpec, Cucumber, Shoulda, MiniTest & Test::Unit;JavaScript/CoffeeScript debugger;Git, Subversion, Mercurial, Perforce and CVS integration;Ruby Debugger\",\n   slug:\"rubymine\",\n   popularity:0,\n   layer:{  \n      id:3,\n      name:\"DevOps\",\n      slug:\"devops\"\n   },\n   category:{  \n      id:185,\n      name:\"Build, Test, Deploy\",\n      slug:\"build-test-deploy\",\n      canonical_url:\"http://stackshare.io/build-test-deploy\"\n   },\n   function:{  \n      id:259,\n      name:\"Integrated Development Environment\",\n      slug:\"ide\",\n      canonical_url:\"http://stackshare.io/ide\"\n   },\n   verified:false,\n   trending_score_for_today:3,\n   trending_score_for_week:220,\n   canonical_url:\"http://stackshare.io/rubymine\",\n   total_vote_count:189,\n   reasons:[  \n      {  \n         one_liner:\"Productive\",\n         vote_count:31\n      },\n      {  \n         one_liner:\"Ruby on Rails\",\n         vote_count:25\n      },\n      {  \n         one_liner:\"Ruby\",\n         vote_count:19\n      },\n      {  \n         one_liner:\"Great UI\",\n         vote_count:15\n      },\n      {  \n         one_liner:\"Rubby Debugger\",\n         vote_count:13\n      },\n      {  \n         one_liner:\" Detecting Code Styles\",\n         vote_count:11\n      },\n      {  \n         one_liner:\"Version Control\",\n         vote_count:9\n      },\n      {  \n         one_liner:\"Unit Testing\",\n         vote_count:8\n      },\n      {  \n         one_liner:\"EditorConfig\",\n         vote_count:7\n      },\n      {  \n         one_liner:\"Database Tools\",\n         vote_count:4\n      }\n   ]\n}"}]},"method":"get","params":[],"results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/v1/tools/explore","auth":"required"},"category":"55c540a15c5d9f0d004969b8","createdAt":"2015-08-27T21:46:43.038Z","__v":6,"body":"","link_url":"","order":3,"title":"/tools/explore","version":"55c53c0f5c5d9f0d004969af","excerpt":"This is the most interesting endpoint as it will give you 50 random tools every time. Come and explore the amazing tools on StackShare.","hidden":false,"link_external":false,"slug":"toolsexplore","sync_unique":"","githubsync":"","project":"55c53c0e5c5d9f0d004969ac","type":"get","updates":[],"user":"55c5401352a1ca0d00b1197f","childrenPages":[]}

get/tools/explore

This is the most interesting endpoint as it will give you 50 random tools every time. Come and explore the amazing tools on StackShare.


User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55dfe88a6dd2da0d0040416d","createdAt":"2015-08-28T04:50:18.949Z","order":4,"updates":[],"project":"55c53c0e5c5d9f0d004969ac","type":"get","version":"55c53c0f5c5d9f0d004969af","__v":6,"excerpt":"Get all the layers on StackShare; layer is the most general level in our taxonomy.","slug":"toolslayers","sync_unique":"","title":"/tools/layers","api":{"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/v1/tools/layers","auth":"required","examples":{"codes":[{"language":"json","code":"[  \n   {  \n      id:1,\n      name:\"Application and Data\",\n      slug:\"application_and_data\"\n   },\n   {  \n      id:2,\n      name:\"Utilities\",\n      slug:\"utilities\"\n   },\n   {  \n      id:3,\n      name:\"DevOps\",\n      slug:\"devops\"\n   },\n   {  \n      id:4,\n      name:\"Business Tools\",\n      slug:\"business_tools\"\n   }\n]","name":""}]},"method":"get","params":[]},"body":"","category":"55c540a15c5d9f0d004969b8","githubsync":"","hidden":false,"link_external":false,"link_url":"","user":"55c5401352a1ca0d00b1197f","childrenPages":[]}

get/tools/layers

Get all the layers on StackShare; layer is the most general level in our taxonomy.


User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55dfe86f063d820d0064227e","api":{"auth":"required","examples":{"codes":[{"language":"json","code":"[  \n   {  \n      id:33,\n      name:\"Payments\",\n      slug:\"payments\",\n      layer:2,\n      canonical_url:\"/payments\"\n   },\n   {  \n      id:177,\n      name:\"Analytics\",\n      slug:\"analytics\",\n      layer:2,\n      canonical_url:\"/analytics\"\n   },\n   {  \n      id:178,\n      name:\"Application Hosting\",\n      slug:\"application-hosting\",\n      layer:1,\n      canonical_url:\"/application-hosting\"\n   }\n]","name":""}]},"method":"get","params":[],"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/v1/tools/categories"},"category":"55c540a15c5d9f0d004969b8","createdAt":"2015-08-28T04:49:51.437Z","link_external":false,"__v":5,"excerpt":"Category is one level lower than layer in our taxonomy.","githubsync":"","slug":"toolscategories","sync_unique":"","version":"55c53c0f5c5d9f0d004969af","body":"","hidden":false,"order":5,"project":"55c53c0e5c5d9f0d004969ac","type":"get","link_url":"","title":"/tools/categories","updates":[],"user":"55c5401352a1ca0d00b1197f","childrenPages":[]}

get/tools/categories

Category is one level lower than layer in our taxonomy.


User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format



{"_id":"55dfe87e34d6830d0091c569","version":"55c53c0f5c5d9f0d004969af","githubsync":"","order":6,"type":"get","editedParams2":true,"link_url":"","project":"55c53c0e5c5d9f0d004969ac","slug":"toolsfunctions","title":"/tools/functions","category":"55c540a15c5d9f0d004969b8","createdAt":"2015-08-28T04:50:06.855Z","editedParams":true,"excerpt":"Function is the lowest level in our taxonomy.","user":"55c5401352a1ca0d00b1197f","api":{"params":[{"in":"query","_id":"55e9fbb0c62aa02f008229a9","required":false,"desc":"This is an optional page number for tools functions; first page will be given by default if page is absent. Example: https://api.stackshare.io/v1/tools/functions?p=3&access_token=ACCESSTOKEN","default":"optional","type":"int","name":"page"}],"results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"settings":"","url":"/v1/tools/functions","auth":"required","examples":{"codes":[{"language":"json","code":"[  \n   {  \n      id:1,\n      category_id:179,\n      name:\"Agile Project Management\",\n      slug:\"agile-project-management\",\n      canonical_url:\"/agile-project-management\"\n   },\n   {  \n      id:2,\n      category_id:177,\n      name:\"Custom Analytics\",\n      slug:\"custom-analytics\",\n      canonical_url:\"/custom-analytics\"\n   },\n   {  \n      id:3,\n      category_id:177,\n      name:\"Analytics Integrator\",\n      slug:\"analytics-integrator\",\n      canonical_url:\"/analytics-integrator\"\n   },\n   {  \n      id:4,\n      category_id:177,\n      name:\"Business Dashboards\",\n      slug:\"business-dashboards\",\n      canonical_url:\"/business-dashboards\"\n   },\n   {  \n      id:5,\n      category_id:184,\n      name:\"Content Delivery Network\",\n      slug:\"cdn\",\n      canonical_url:\"/cdn\"\n   }\n]","name":""}]},"method":"get"},"body":"","sync_unique":"","updates":[],"__v":5,"hidden":false,"link_external":false,"childrenPages":[]}

get/tools/functions

Function is the lowest level in our taxonomy.

Query Params

page:
integeroptional
This is an optional page number for tools functions; first page will be given by default if page is absent. Example: https://api.stackshare.io/v1/tools/functions?p=3&access_token=ACCESSTOKEN

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}

Definition

{{ api_url }}{{ page_api_url }}

Examples


Result Format