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, AutomationWhat 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 tohttps://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 underhttps://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, addqand 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 - 4
4. Use the answer
The response body is a variable in every later step.
data.answer.valueholds a short answer when the pages give one, anddata.sourceslists each page with itstitle,urlandsnippet. 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.sourcesfrom the Call API step into Data to use in the code assources, and return a list:Run Custom Code
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:
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].