2d:null 2e:["$","title",null,{"children":"StackShare API | Nikita Sharov | Observable"}] 33:[] 31:{"id":"ecb6a0bd2b08bded","slug":"stackshare-api","title":"StackShare API","thumbnail":"acfb9154bb451c2af5a6f358f449fb6b55f12e00d91a1f518b04c6fa5aba0d8d","access_level":"public","create_time":"$D2020-10-13T09:10:22.357Z","update_time":"$D2021-05-08T15:38:19.225Z","view_time":null,"first_public_time":"$D2020-10-14T07:57:52.376Z","has_unpublished_edits":null,"fork":false,"stars":0,"starred":false,"owner":{"type":"team","id":"6c49d8d38db08400","login":"nikita-sharov","name":"Nikita Sharov","avatar_url":"https://avatars-next.observableusercontent.com/544afb614871e9f3bee546cbff7e689f2a454464b16ac434007893bde877f2df","tier":"starter_2024"},"version":519,"publish_version":519,"role":null,"authored":false,"authors":[{"type":"individual","id":"ee7c67b988c5530c","login":"nikita-sharov","name":"Nikita Sharov","avatar_url":"https://avatars-next.observableusercontent.com/544afb614871e9f3bee546cbff7e689f2a454464b16ac434007893bde877f2df","tier":null}],"members":[{"type":"individual","id":"ee7c67b988c5530c","login":"nikita-sharov","name":"Nikita Sharov","avatar_url":"https://avatars-next.observableusercontent.com/544afb614871e9f3bee546cbff7e689f2a454464b16ac434007893bde877f2df","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":4,"collection":{"id":"0d8b57ba92da7b34","slug":"apis","title":"APIs","owner":{"id":"6c49d8d38db08400","login":"nikita-sharov","name":"Nikita Sharov"}},"type":"notebook","body":{"title":"StackShare API","cells":[{"id":0,"value":"md`# StackShare API\n\n[Official documentation](https://docs.stackshare.io/v1.0/docs) (v1.0, GraphQL); free trial (100 API requests per month)`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":12,"value":"apiKey = {\n try {\n return Secret(\"StackShare API\")\n } catch {\n // Secrets are only available in private notebooks\n return `\n1. Fork this notebook.\n2. Get your own API key. \n3. Store it as a secret.`;\n }\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":469,"value":"md`Believe it or not, but I’m going to fork this notebook myself, keeeping it private, to be able to use my own API key as a secret.\n\n> [Stuntman Mike](https://www.imdb.com/title/tt1028528/characters/nm0000621): It’s better than safe. It’s death proof.`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":25,"value":"md`\nNow, we are looking for ~~young women~~ [technology meta data](https://docs.stackshare.io/docs/tools),\n\n> Tools include but are not limited to languages, libraries, frameworks, Software as a Service (SaaS) solutions, cloud infrastructure, business services, open source projects, and other software products and services. You can browse StackShare to see which tools are available [here](https://stackshare.io/categories) or [search](https://stackshare.io/search) [giving you different results] using the UI.\n\n[asking](#query) for all fields we can get—not that many, actually, and often unset, although… It [doesn’t hurt](https://docs.stackshare.io/docs/count#how-are-api-requests-counted) to ask!\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":490,"value":"viewof trigger = radio({\n title: \"Search\",\n options: [\n {label: \"while typing\", value: \"oninput\"},\n {label: \"on submission\", value: \"onsubmit\"}\n ],\n value: \"onsubmit\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":67,"value":"viewof toolName = text({\n title: \"Search for\",\n placeholder: \"D3.js\", \n submit: trigger === \"onsubmit\" ? \"Submit\" : undefined,\n description: \"The maximum result count for a single query is 25; to get more tools, implement pagination.\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":109,"value":"tools = {\n if (toolName) {\n return fetchTools(toolName);\n } else {\n return placeholderResponse;\n }\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":141,"value":"{\n const titledTools = tools.edges\n .map(d => d.node)\n .filter(d => d.title);\n \n let content = `\n

\n`; \n for (const tool of titledTools) {\n const canonicalUrl = tool.canonicalUrl ?? `https://stackshare.io/${tool.slug}`;\n \n // StackShare is denying access to several hosted images\n const fallbackImageUrl = \"https://img.stackshare.io/no-img-open-source.png\";\n content += `\n\n

${tool.title}

\n\n`;\n }\n \n content += `\n

\n`;\n return html`${content}`;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":21,"value":"fetchTools = async (name) => {\n const response = await fetch(endpoint, options(query(name)))\n .then(response => response.json());\n \n if (!response.data) {\n throw response.message;\n } \n \n return response.data.tools;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":7,"value":"endpoint = \"https://api.stackshare.io/graphql\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":17,"value":"options = (query) => {\n return {\n method: \"POST\",\n headers: { \n \"Content-Type\": \"application/json\",\n \"Accept\": \"application/json\",\n \"x-api-key\": apiKey.replaceAll(\"\\n\", \"\")\n },\n body: JSON.stringify({query})\n };\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":14,"value":"query = (tool) => `{\n tools(query: \"${tool}\") {\n count\n pageInfo {\n hasPreviousPage\n startCursor\n hasNextPage\n endCursor\n }\n edges {\n node {\n name\n title\n slug\n canonicalUrl\n id\n imageUrl\n ossRepo\n description\n websiteUrl\n }\n }\n }\n}`","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":131,"value":"placeholderResponse = ({\n count: 1,\n pageInfo: {\n hasPreviousPage: false,\n startCursor: \"MQ\",\n hasNextPage: false,\n endCursor: \"MQ\"\n },\n edges: [\n {\n node: {\n name: \"D3.js\",\n title: \"A JavaScript visualization library for HTML and SVG\",\n slug: \"d3\", // should be; actually is: d3-js, redirecting to https://stackshare.io/companies/d3-js\n canonicalUrl: \"https://stackshare.io/d3\", // should be; actually is: null\n id: \"VG9vbC0xNTMx\",\n imageUrl: \"https://img.stackshare.io/service/1491/HgKolWB5_400x400.jpg\",\n ossRepo: \"https://github.com/d3/d3\",\n description: \"It is a JavaScript library for manipulating documents based on data. Emphasises on web standards gives you the full capabilities of modern browsers without tying yourself to a proprietary framework.\",\n websiteUrl: \"http://d3js.org/\"\n }\n }\n ]\n})","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":121,"value":"md`---\n## Appendix`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":63,"value":"import {radio, text as styledText} from \"@jashkenas/inputs\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":90,"value":"text = (options) => {\n const text = styledText(options); \n \n // css override (unset !important) of the inline style shows no effect \n text.querySelector(\"input[type='text']\").setAttribute(\"style\", null);\n return text;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":167,"value":"html``","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W33","stdlib":"1","titling":"auto"}} 32:"$31:body"