Octen / Search the web

Octen tool octen-web-search on looot: input fields, $0.006 per call, output shape, and code to run it with curl, JavaScript or Python.

Searches the live web and returns ranked results with highlights and optional full content. Send query; count, domains, text filters, time range and language refine it.

Tool id: octen-web-search
Provider: Octen
Job: Search the web and get ranked results (web.search)
Price: $0.006 per call. A call that fails at the provider costs $0.

Inputs

Name	Type	Required	Description
`count`	integer	no	Results per search. Octen allows up to 100; bounded here to 20.
`end_time`	string	no	ISO 8601 end time for filtering results.
`exclude_domains`	array	no	Domains to exclude from results.
`exclude_text`	array	no	Strings that must not appear in the result page text.
`format`	string	no
`full_content`	object	no
`highlight`	object	no
`include_domains`	array	no	Domains to restrict results to.
`include_images`	boolean	no
`include_text`	array	no	Strings that must appear in the result page text.
`language`	array	no	ISO 639-1 language codes to restrict results to.
`query`	string	yes	The search query. Supports site:<domain> / -site:<domain> operators. Example: “open source vector databases”
`safesearch`	string	no
`start_time`	string	no	ISO 8601 start time for filtering results.
`time_basis`	string	no
`time_range`	string	no	Relative time window. Mutually exclusive with start_time/end_time.

Output

Shape of the run’s result, checked against 3 real answers:

{ msg, code, data: { query, results: { url, title, authors, favicon, highlight, full_content, time_published, time_last_crawled }[] }, meta: { usage: { num_search_queries, full_content_tokens, full_content_extra_count }, latency, warning }, request_id }

Every call needs your API token in LOOOT_TOKEN; Sign in shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With wait: 30 the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll GET /v1/runs/<runId>.

Example input with placeholder values:

curl -X POST "https://api.looot.ai/v1/runs" \
  -H "Authorization: Bearer $LOOOT_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"endpointId":"octen-web-search","input":{"query":"open source vector databases"},"wait":30}'

const response = await fetch("https://api.looot.ai/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOOOT_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    endpointId: "octen-web-search",
    input: {
      query: "open source vector databases",
    },
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);

import os
import uuid

import requests

response = requests.post(
    "https://api.looot.ai/v1/runs",
    headers={
        "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "endpointId": "octen-web-search",
        "input": {
            "query": "open source vector databases",
        },
        "wait": 30,
    },
    timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))

To let looot pick among every provider of this job instead, send job:web.search as endpointId; see the job page.

Octen / Search the web

Inputs

Output

Run it