Skip to the page

Softr

Connect SpecStream to Softr as a REST API integration, and a workflow's Call API step searches the live web or reads a page. The answer and its pages come back as variables for the steps that follow.

SpecStream for Softr, Automation

What you need

  • A Softr workspace on the Professional plan or above, which the Call API workflow action needs.
  • A SpecStream account. New accounts start with $10 of credit, no card. Create one.
  • A SpecStream API key with a spending limit, which step 1 creates.
  1. 1. Create an API key

    In your SpecStream workspace, open Agents & API, choose API keys, then Create API key. Turn on Authorize paid work: a key without it can't search or read pages. Set a Total spending limit above $0, because that limit is what caps the spending of everything that uses the key.

    Copy the key when it's shown. It isn't shown again.

  2. 2. Connect SpecStream as a REST API

    In the Softr Studio dashboard, click Integrations in the left menu, then Connect new, and pick Rest API.

    Set Provider to SpecStream, Authentication type to API key, and Base URL to https://api.specstream.ai. Select Bearer token, paste your SpecStream key in API key, and click Continue. With a Base URL set, Softr sends the key only to addresses under https://api.specstream.ai.

  3. 3. Add a Call API step

    In your workflow, after the trigger, add the Call API action. Set Method to GET and URL to https://api.specstream.ai/v1/web-search. Under Query parameters, add q and set its value with the + variable picker, for example the company name or the question field of the record that started the workflow. Under Authentication, pick the SpecStream integration.

    Call API
    Method: GET
    URL: https://api.specstream.ai/v1/web-search
    Query parameter: q = Latest funding round of {Company name}
    Authentication: SpecStream
  4. 4. Use the answer

    The response body is a variable in every later step. data.answer.value holds a short answer when the pages give one, and data.sources lists each page with its title, url and snippet. Map them into an Update record step, a Slack message, or an AI step's prompt.

    To turn the pages into one text field, add Run Custom Code (Pro plan and above), map data.sources from the Call API step into Data to use in the code as sources, and return a list:

    Run Custom Code
    const sources = inputData.sources || [];
    return {
    links: sources.map((s) => `${s.title}: ${s.url}`).join("\n"),
    };

Read a page

Add another Call API step with Method POST, URL https://api.specstream.ai/v1/extract, the SpecStream integration as Authentication, and this body, with the URL field of your record in place of the address. The page's main text is data.results[0].text in the response, when data.results[0].status is ok:

Request body
{
"urls": ["https://www.example.com/pricing"],
"format": "markdown"
}

Status codes

A step that fails shows the status SpecStream answered. 401 means the integration's key is missing or wrong. 403 means the key has no Authorize paid work or would go over its spending limit. 402 means the balance is empty. 503 means search is busy: run the step again after a few seconds.

Cost

Each Call API search is $5 per 1,000 searches of up to 10 results, or $1 per 1,000 with a speed query parameter set to fast. A page read is $0.80 per 1,000 pages. They come out of your SpecStream balance up to the key's spending limit, with no quote and no approval. Balance, quotes, and billing has the details.

Remove

Delete the SpecStream integration on the Integrations page, and remove the Call API steps that use it. To stop the key working everywhere, revoke it under API keys in Agents & API. Results already delivered stay in your workspace. Questions go to [email protected].

More

SpecStream for Softr covers what it does in Softr on one page. Every other tool has its guide in Connect your tools. You see the most a request can cost before it starts, and the matches are paid from your balance. Billing has the details. For help, email [email protected].