https://specstream.ai/component---src-pages-docs-getting-started-tsx-a487bc3f389e524bc8ea.js

1"use strict";(self.webpackChunkspecstream_website=self.webpackChunkspecstream_website||[]).push([[8265],{13626:function(e,t,n){n.d(t,{A:function(){return o}});var i=n(30758),r=n(67733),a=n(95709);function o(e){let{id:t,children:n}=e;const o=a.V[t];return o?i.createElement(r.A,{to:"/docs/glossary#"+t,preview:{title:o.term,description:o.plain,ctaLabel:"All the words we use"},className:"term-link"},n||o.term.toLowerCase()):i.createElement(i.Fragment,null,n)}},47233:function(e,t,n){n.d(t,{A:function(){return a}});var i=n(30758);const r={rust:"text-rust dark:text-red-2",green:"text-green-dark dark:text-green",cobalt:"text-cobalt dark:text-blue-2",gold:"text-gold-dark dark:text-gold"};function a(e){let{children:t,tone:n="rust",as:a="span",className:o=""}=e;return i.createElement(a,{className:"ink-stamp "+r[n]+" "+o},t)}},55956:function(e,t,n){n.r(t),n.d(t,{Head:function(){return u},default:function(){return c}});var i=n(30758),r=n(77528),a=n(67733),o=n(41251),s=n(13626),d=n(47233);function l(e){let{groups:t,caption:n}=e;return i.createElement("figure",{className:"not-prose border border-primary rounded-md bg-accent p-4 my-5"},i.createElement("ul",{className:"m-0 p-0 list-none space-y-3"},t.map(e=>{let{label:t,joiner:n,tone:r,parts:a}=e;return i.createElement("li",{key:t,className:"m-0 flex flex-wrap items-center gap-2"},i.createElement(d.A,{tone:r,className:"!text-[11px] min-w-[5.5rem] text-center mr-1"},t),a.map((e,t)=>i.createElement(i.Fragment,{key:e},t>0&&n&&i.createElement("span",{className:"text-sm text-secondary"},n),i.createElement("span",{className:"rounded border border-primary bg-primary px-2.5 py-1 text-sm font-bold shadow-[0_2px_0_rgb(var(--input-border))]"},e))))})),n&&i.createElement("figcaption",{className:"text-sm text-secondary mt-3"},n))}function c(){return i.createElement(r.A,{title:"Find your first results",filename:"getting-started.mdx",toc:[{url:"#describe",value:"Describe the work"},{url:"#review",value:"Watch it read, then start"},{url:"#results",value:"Use the results"}]},i.createElement("p",null,"Start with what you need to find and the details you want back. If you already have a list, you can ",i.createElement(a.A,{to:"/docs/workspace#sharing"},"import it")," from a CSV or Excel file, Google Sheets, or Airtable instead."),i.createElement("h2",{id:"describe"},"1. Describe what you need."),i.createElement("p",null,i.createElement(a.A,{to:"/signup"},"Create an account")," and open a new request. Use everyday language to explain what you're looking for, which details make a result qualify, and what information you want returned. Include a quantity, exclusions, or an order when they matter."),i.createElement("blockquote",null,"Find software companies in Germany with 50 to 500 employees that are hiring salespeople. Include the job post and the contact email."),i.createElement("p",null,'Say it the way you\'d say it to a person, with "and," "or," and "but not" included. Those words change the answer, so SpecStream keeps every one of them:'),i.createElement("blockquote",null,"Find software companies in France founded after 2020 that sell to developers or data teams, but not agencies."),i.createElement(l,{groups:[{label:"All of",joiner:"and",tone:"green",parts:["In France","Founded after 2020"]},{label:"Any of",joiner:"or",tone:"cobalt",parts:["Sells to developers","Sells to data teams"]},{label:"None of",tone:"rust",parts:["Agencies"]}],caption:"A keyword search would return an agency that mentions developers. SpecStream leaves it out."}),i.createElement("p",null,"Not sure how to put it? Open ",i.createElement("strong",null,"Templates")," in the workspace for requests that already work: shops and venues, companies, products, papers, grants, tenders, jobs, and more. Pick one, change the place or the numbers, and it lands in the box ready to edit."),i.createElement("p",null,"Rather talk? Press the microphone, say it, and press Enter. The words land in the box as if you'd pasted them, and nothing runs until you press Find. The recording isn't kept."),i.createElement("p",null,"A request can ask for 1 to 2,000 results (25 if you don't say) and run to 16,000 characters. Requests are read in English. Names, quoted text and web addresses in any language stay exactly as written, and sources in other languages are read."),i.createElement("p",null,"Available fields and sources depen

1d on the type of record and the requirements you choose. ",i.createElement(a.A,{to:"/docs/sources"},"See where SpecStream looks"),"."),i.createElement("h2",{id:"review"},"2. Watch it read."),i.createElement("p",null,"As each word is finished, the card under the box writes up the list your request will become: its name, a column for every rule and detail, and a few empty rows. Your words stay exactly as you typed them. ",i.createElement("strong",null,"Must have"),", ",i.createElement("strong",null,"Only if")," and ",i.createElement("strong",null,"Leave out")," are ",i.createElement(s.A,{id:"required-detail"},"requirements")," every result must meet; the rest are ",i.createElement(s.A,{id:"optional-detail"},"details")," to bring back."),i.createElement("p",null,"Wording SpecStream can't read yet gets a line under it when you pause, with Rephrase, Remove and Pick a detail. Nothing is guessed or quietly dropped, and there's no interpretation to approve: change the words until the card says ",i.createElement("strong",null,"Ready"),", then press Find."),i.createElement("h2",null,"3. Review the quote and start."),i.createElement("p",null,"New work gets a ",i.createElement(s.A,{id:"quote"},"quote")," for the exact request ",i.createElement(s.A,{id:"revision"},"revision")," and operation. Review the ",i.createElement(s.A,{id:"approved-maximum"},"maximum spend")," and the useful minimum before you approve it. Changing the scope means a new quote. Saving a request or adding balance doesn't start any work."),i.createElement("p",null,i.createElement("strong",null,"Watch it work.")," Progress and results arrive while it runs, so you can watch the list fill in. Changed your mind? ",i.createElement("strong",null,"Stop work")," keeps what already qualified, and you pay for those at the quoted rate. If fewer than the ",i.createElement(s.A,{id:"useful-minimum"})," qualified, you pay $0 and none are kept."),i.createElement("p",null,i.createElement("strong",null,"If anything is uncertain,")," like a connection that drops mid-purchase, choose ",i.createElement("strong",null,"Check again"),". SpecStream recovers the original purchase by its key instead of starting the work twice."),i.createElement("h2",{id:"results"},"4. Inspect the evidence."),i.createElement("p",null,"Open a result to see the sources and checks behind each fact. A missing optional field is different from an ",i.createElement(s.A,{id:"unresolved"},"unresolved")," required detail. ",i.createElement(a.A,{to:"/docs/evidence"},"Learn how to read evidence"),"."),i.createElement("p",null,"Every result went through the same checks, and the same evidence always gives the same answer. ",i.createElement(a.A,{to:"/research#how-it-works"},"See how it works"),"."),i.createElement("h2",null,"5. Keep going."),i.createElement("p",null,"Save results in a collection, export them, send them to ",i.createElement(a.A,{to:"/docs/integrations"},"Google Sheets, your CRM, or another connected tool"),", or share a selected ",i.createElement(s.A,{id:"snapshot"},"snapshot"),". You can ",i.createElement(s.A,{id:"find-more"},"find more results"),", ",i.createElement(s.A,{id:"add-details"},"gather additional details"),", or ",i.createElement(s.A,{id:"refresh"},"recheck existing facts"),". Each new operation has its own quote."),i.createElement(r.u,null,"Open SpecStream"))}const u=()=>i.createElement(o.A,{path:"/docs/getting-started",title:"Find your first results",description:"Describe what to find in everyday language, review the request and quote, run it, and inspect the results with their sources."})},77528:function(e,t,n){n.d(t,{A:function(){return d},u:function(){return l}});var i=n(30758),r=n(24960),a=n(39106),o=n(5356),s=n(39047);function d(e){let{children:t,title:n,filename:a,home:d=!1,toc:l=[]}=e;const{appWindow:c}=(0,o.ox)(),{setWindowTitle:u}=(0,s.w0)();return(0,i.useEffect)(()=>{c&&u(c,a)},[null==c?void 0:c.key,a]),i.createElement(r.Ay,{title:n,proseSize:d?"lg":"base",hideLeftSidebar:d,hideRightSidebar:!l.length,tableOfContents:l,hideMarkdownActions:!0,showQuestions:!1},t)}function l(e){let{children:t="Get started – free"}=e;return i.createElement(a.A,{asLink:!0,to:"/signup",variant:"primary",size:"lg"},t)}},95709:function(e,t,n){n.d(t,{V:function(){return o},q:function(){return a}});n(95926),n(23941),n(43945);var i=n(30758),r=n(67733);const a=[{title:"Asking",terms:[{term:"Request",id:"request",definition:"What you want found, in y

1our own words. Requests are saved with revisions."},{term:"Revision",id:"revision",definition:"A saved version of a request. Editing creates a new revision; earlier ones stay exactly as they were."},{term:"Interpretation",id:"interpretation",definition:"How SpecStream read your request, as parts you can edit: what to find, where, conditions, exclusions, order, quantity, and the details to return. Ambiguous or unsupported details stay visible."},{term:"Record type",id:"record-type",plain:"The kind of thing you are looking for, such as local businesses, grants, or clinical trials.",definition:i.createElement(i.Fragment,null,"The kind of thing you are looking for, such as local businesses, grants, or clinical trials."," ",i.createElement(r.A,{to:"/things-worth-finding"},"See them all"),".")},{term:"Required detail",id:"required-detail",definition:"A detail a result needs usable evidence for before it can qualify."},{term:"Optional detail",id:"optional-detail",definition:"A detail you'd like back. If nobody published it, it stays empty and the result can still qualify."},{term:"Request link",id:"request-link",definition:"A reusable link to a reviewed request revision. The recipient can save a copy; they don't get your results or your balance."}]},{title:"Paying",terms:[{term:"Quote",id:"quote",definition:"The price for the exact request revision and operation: the rate, the quantity, the useful minimum, and the maximum. Valid for 30 minutes."},{term:"Rate",id:"rate",definition:"What one qualified result costs: Standard $0.05, Expanded $0.10, or Deep $0.20. The quote says which one applies."},{term:"Approved maximum",id:"approved-maximum",definition:"The most a piece of work can cost. It's set aside before the work starts, and the charge can never exceed it."},{term:"Useful minimum",id:"useful-minimum",definition:"The fewest qualified results worth paying for. If the work finds fewer, or stops before reaching it, the charge is $0 and none are kept."},{term:"Balance",id:"balance",definition:"The dollars your work draws from. People, agents, API clients, and schedules share it."},{term:"Top-up",id:"top-up",definition:"Balance you buy, from $10 in whole-dollar amounts. It doesn't expire."},{term:"Correction",id:"correction",definition:"A claim for objectively defective billed results, filed within seven days with Report a wrong result on the record. A confirmed defect returns the affected balance."}]},{title:"Finding and checking",terms:[{term:"Qualified",id:"qualified",definition:"The result meets every required condition, with usable evidence for its required details. Only qualified results are charged."},{term:"Excluded",id:"excluded",definition:"The evidence shows the result fails a requirement."},{term:"Unresolved",id:"unresolved",definition:"SpecStream couldn't establish the fact: a source didn't respond or the evidence wasn't good enough. It isn't a no."},{term:"Evidence",id:"evidence",definition:"The source and observation time behind a fact, and which requirement it supports."},{term:"Decision",id:"decision",definition:"The recorded checks behind a result: observed values, sources, dates, and the outcome."},{term:"Decision replay",id:"decision-replay",definition:"Re-runs the recorded checks against the saved evidence. No new search, no model calls, no charge."},{term:"Evidence-bound AI",id:"evidence-bound",definition:"A model that answers narrow questions about a page with calibrated confidence instead of writing text. It can't invent a value, stand in for a source, or pass a result on its own; fixed rules decide from the evidence."},{term:"Deterministic",id:"deterministic",definition:"Same evidence, same answer, every time. A model reads your request; fixed rules decide whether a result qualifies. That's why a decision can be replayed."},{term:"Cross-check",id:"cross-check",definition:"Checking a fact against more than one source. When sources disagree, the conflict stays visible instead of one of them winning quietly."},{term:"Historical copy",id:"historical-copy",definition:"An archived copy of a page, labeled with the date it was captured. It can support a fact about the past; it never passes for what's true today."}]},{title:"Keeping the work going",terms:[{term:"Find more",id:"find-more",definition:"Look for additional qual

1ifying results. Ones you already own aren't bought again."},{term:"Add details",id:"add-details",definition:"Gather new details about retained results. Only the new details are priced."},{term:"Refresh",id:"refresh",definition:"Recheck retained results. It reports what was verified, no longer matches, stayed unresolved, was unavailable, or wasn't reached."},{term:"Monitor",id:"monitor",definition:"A saved operation on a schedule, with a cadence, a timezone, a limit per run, and a monthly limit. Watch for new ones sets one up from a found list."},{term:"Occurrence",id:"occurrence",definition:"One scheduled run. If the balance or permission isn't there, the occurrence is blocked: nothing runs and nothing is charged."}]},{title:"Organizing and sharing",terms:[{term:"Collection",id:"collection",definition:"Records from a find or an import, with table, list, map, compare, and history views."},{term:"Combine",id:"combine",definition:"Make one collection from several. A place or company that appears in more than one is kept once, and the originals stay as they are."},{term:"Your fields",id:"your-fields",definition:"Columns you add to a collection and fill in yourself: a Status with options you name, a Checkbox, or Text. SpecStream never changes them."},{term:"Embed",id:"embed",definition:"The map from a share link, shown on your own site for as long as the link lasts."},{term:"Plan a route",id:"route",definition:"A visiting order through up to 11 selected places, opened as Google Maps directions or copied as a list."},{term:"Import",id:"import",definition:"A CSV or Excel file you bring, or a linked Google Sheet or Airtable view, up to 2,000 rows and 2 MB. Your values stay labeled as yours; importing doesn't start paid work."},{term:"Saved view",id:"saved-view",definition:"Filters, visible columns, sorting, map area, and view type, saved to come back to."},{term:"Snapshot",id:"snapshot",definition:"A fixed selection of results that never changes. Share it with an expiry date, optional download, and your choice of contact visibility."},{term:"Relationship",id:"relationship",definition:"A connection between records through a value in one of your columns. Missing values stay unconnected."},{term:"Project",id:"project",definition:"Where related collections, notes, members, and spending limits live. Members are owners, editors, or viewers."},{term:"Note",id:"note",definition:"A comment on a project or a record, up to 8,000 characters. Mention someone by email and they get it by email."},{term:"Destination",id:"destination",definition:"Where selected results land in a connected tool: a sheet, table, database, board, or CRM, with fields mapped first. It can keep receiving new records as they qualify."},{term:"Template",id:"template",definition:"A request that already works, ready to edit. Change the place or the numbers, then find."}]},{title:"Agents and developers",terms:[{term:"API key",id:"api-key",definition:"Credentials for the API and MCP, with read, prepare, or execute scope, optional project limits, an expiry date, and a spending ceiling."},{term:"Delegated access",id:"delegated-access",definition:"Permission for an agent to start specific work within a per-run limit, a monthly limit, and an expiry date."},{term:"OAuth client",id:"oauth-client",definition:"An application you register and approve, with its permissions reviewed separately. You can revoke it."},{term:"Webhook",id:"webhook",definition:"A signed message to your endpoint when a find completes, a monitor finds something new, or records are added to a collection. The signing secret is shown once, at creation."},{term:"Single sign-on",id:"single-sign-on",definition:"Signing in through your company's identity provider over SAML, on a domain you verified. With SCIM, people join and leave with their provider account."},{term:"Audit log",id:"audit-log",definition:"Who signed in, created keys, approved spending, exported, or set up monitors, and when. Kept for 12 months."},{term:"MCP",id:"mcp",plain:"The Model Context Protocol endpoint agents use to work in SpecStream.",definition:i.createElement(i.Fragment,null,"The Model Context Protocol endpoint agents use to work in SpecStream. ",i.createElement(r.A,{to:"/docs/mcp"},"Connect an agent"),".")}]}],o=Object.fromEntries(a.flatMap(e=>e.terms).map(e=>{let{id:t,term:n,definition:i,plain:r}=e;return[t,{term:n,plain:r||("string"==typeof i?i:n)}]}))}}]);