Buy a list from the live web, paid per match

Without a payment this answers 402 with the most the run can cost. Pay with MPP or x402 and send the same request again to start the run.

post/v1/agent/lists

Request

  • Base URL: https://api.specstream.ai
  • URL: https://api.specstream.ai/v1/agent/lists
  • Auth: none declared

Request body

requeststring required

The list you need, in plain words.

countinteger

How many matches to look for.

Example request

{
  "request": "coffee shops in Narbonne, France",
  "count": 3
}

Response

Paid. The run has started; read status_url.

purchase_idstring required
tokenstring required

Send as Authorization: Bearer <token> to read the purchase.

status_urlstring uri required
read_withstring
paidstring

Dollars charged by card, when paid by card.

authorizedstring

Dollars authorized in USDC, when paid over x402.

currencystring
readingobject
find_idstring
statusstring
notestring

Changes

No recorded changes to this operation across all 1 revision of this API.