Deep Search across the entire live web

Ask in plain words. Get every match on the live web, in structured rows. You approve the price before it runs, and only rows delivered are charged.

Start freeRead the docs

Read, quote, approve, read the rows

# Read the request
curl https://api.specstream.ai/v1/parse \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "Specialty coffee roasters in Lyon, France, with their website"}'

# Quote the reading
curl https://api.specstream.ai/v1/capacity/quotes \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ast_hash": "<ast_hash>"}'

# Approve the maximum
curl https://api.specstream.ai/v1/capacity/executions \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quote_id": "<quote_id>", "quote_hash": "<quote_hash>",
       "confirm_max_cents": <maximum>, "idempotency_key": "<your key>"}'

# Read the rows
curl https://api.specstream.ai/v1/finds/<find_id>/rows \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY"

Rows, cut short

{
  "status": "completed",
  "accepted_count": 3,
  "rows": [
    {
      "billable": true,
      "cells": [
        { "label": "Business", "value": "FIKA ROASTERS" },
        { "label": "Where", "value": "2 Rue Fernand Rey, 69001 Lyon, France" },
        { "label": "Reviews", "value": 70, "display": "4.8 · 70" },
        {
          "label": "Website",
          "value": "http://fikaroasters.fr",
          "source_url": "https://www.fikaroasters.fr/"
        }
      ],
      "checked_at": "2026-11-04T21:18:55Z"
    },
    {
      "billable": true,
      "cells": [
        { "label": "Business", "value": "Celsius Roasters" },
        { "label": "Where", "value": "12 Rue des Capucins, 69001 Lyon, France" },
        { "label": "Reviews", "value": 150, "display": "5.0 · 150" },
        {
          "label": "Website",
          "value": "http://celsius-roasters.fr",
          "source_url": "https://celsius-roasters.fr/"
        }
      ],
      "checked_at": "2026-11-04T21:18:55Z"
    }
  ]
}

What a run returns

Structured rows, one for each match, with the facts you asked for as columns. Source URL and read time on every value.

Mesquite Climate

Austin, Texas

Match

20 to 200 employeesYes
Their careers page counts 166 people on the team.
“Join our team of 166 technicians, installers and office staff.”
Read on their careers page, Sep 27 at 9:10am
Founder-ownedYes
Their about page says the founding family has run it since 2005.
“Family owned and operated in Austin since 2005.”
Read on their about page, Sep 27 at 9:10am
No private-equity ownerYes
Their about page names the family as the only owners, with no investor or parent company.
“Still owned by the Ortega family, with no outside investors.”
Read on their about page, Sep 27 at 9:10am

Left out

Gulf Coast Comfort

Houston, Texas

No private-equity ownerNo

Their about page names a private-equity-backed home services group as owner since 2022.

“Gulf Coast Comfort is proud to be part of the Lonestar Home Services family.”

Read on their about page

One part doesn’t fit, so it costs nothing.

What a run costs

A row costs 5¢, 15¢ or $1. An email adds 5¢ and a phone number adds 15¢. A refresh charges half the rate for changed and new rows and 1¢ for an unchanged one.

5¢: Standard. Up to 5 facts to check or return, with no related list.
15¢: Expanded. Up to 15 facts, plus one related list, such as a company’s jobs or a creator’s posts. 10 related records a result are included, then 10¢ for each further 10.
$1: Deep. Anything beyond Expanded.

10,000 results: Up to 10,000 results a request, in a run of up to four hours.
Price approved first: You see the price and approve it before the run starts.

Also in Deep Search

Deep Search questions

Something we didn't answer? Talk to a human

How do I know what a run will cost?

You see the price and approve it before the run starts. Only rows delivered are charged, and a run that finds nothing costs nothing.

How much can one request return?

Up to 10,000 results, and a run can take up to four hours.

What does a refresh cost?

Half the rate for each changed or new row, and 1¢ for each unchanged one.

How is it different from the Search API?

The Search API answers in a few seconds and shows the first rows. Deep Search returns every match, up to 10,000 results, in up to four hours.

Run your first request

Start freeTalk to a human