browser_run — Orange Slice capability
Outcome-priced capability. One price for the answer, whichever providers it took. Everything we expose, with prices: https://orangeslice.ai/llms.txt
Runs JavaScript in a hosted browser and returns whatever it returns. One credit per run. Reach for it when a page needs interaction that scrape website cannot do — a login, a click, an infinite scroll.
Price
$0.002, charged per call
Billed on every call, including one that returns nothing.
The price is a property of the outcome, not of the work behind it. Whichever vendor serves this call, and whatever it costs us, the number above is the number quoted before the run and charged after it.
Call it
CLI
orangeslice browser run 'const r = await fetch("https://example.com"); return (await r.text()).length'
HTTP
curl -X POST 'https://orangeslice.ai/api/v1/run' \ -H 'Authorization: Bearer $ORANGESLICE_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"capability":"browser_run","input":{"code":"<string>"}}'
SDK
await services.browser.execute({ code: "…" });
Inputs
| Field | Type | Required | Description |
|---|---|---|---|
code | string | Yes | JavaScript to run in the hosted browser. Return a value to get it back. |
timeout_sec | number | No | Seconds before the run is killed. Default is the pool's. |
Inputs may also be piped as NDJSON, one JSON object per line.
Output
{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "result": { "anyOf": [ {}, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "result", "error" ], "additionalProperties": false }
The field that carries the answer is result. It is
null — or empty — when nothing was found, which is how a miss is told from a
hit without knowing anything else about this entry.
Before you run
- Price it first.
orangeslice browser run --dry-runreturns the exact dollar cost and spends nothing. - Large runs need approval. Above the spend-gate threshold a run exits 7 until it carries a plan token, and only a dry run mints one.
- Scopes: enrich
- Permitted uses: research, export
Exit codes
0 ok · 2 bad input · 3 auth · 4 not found · 5 provider ·
6 rate limited · 7 spend gate, nothing billed · 8 timeout ·
9 a third-party account needs connecting