Cookbook
Cookbook
Research across many sources
Read several pages against several questions in one request, rank the answers and total the cost.
1 min read · Updated 20 Nov 2026
On this page
For research, read many pages at once. One Lineage request takes up to 100 documents and 10 questions, and returns an entry for each document and question.
many-sources.py
import osfrom decimal import Decimalimport requestsAPI = "https://fluxsearch.io/api/v1"HEADERS = {"Authorization": f"Bearer {os.environ['FLUX_API_KEY']}"}QUESTIONS = [ "Which companies are mass-producing sodium-ion batteries?", "When does production start?",]def post(endpoint: str, body: dict) -> dict: response = requests.post(f"{API}/{endpoint}", headers=HEADERS, json=body, timeout=300) response.raise_for_status() return response.json()search = post("search", {"query": "sodium-ion battery mass production 2026", "max_results": 6, "enrich": 0})urls = [result["url"] for result in search["results"]]read = post("lineage", {"documents": [{"url": url} for url in urls], "queries": QUESTIONS})for question in QUESTIONS: print(question) entries = [e for e in read["data"] if e["query"] == question] passages = [(p["score"] or 0, urls[e["document_index"]], p) for e in entries for p in e["results"]] for score, url, passage in sorted(passages, key=lambda x: x[0], reverse=True)[:3]: print(f" {score:.2f} {passage['enriched_text'].strip()}") print(f" {url}") print()errors = read.get("errors", [])cost = Decimal(search["usage"]["cost_usd"]) + Decimal(read["usage"]["cost_usd"])print(f"Read {len(urls) - len(errors)} of {len(urls)} pages, {len(errors)} unreadable")print(f"Cost: ${cost:.4f}")const API = "https://fluxsearch.io/api/v1";const QUESTIONS = [ "Which companies are mass-producing sodium-ion batteries?", "When does production start?",];type Usage = { cost_usd_ticks: number };type Passage = { enriched_text: string; score: number | null };type Entry = { document_index: number; query: string; results: Passage[] };async function post<T>(endpoint: string, body: unknown): Promise<T> { const response = await fetch(`${API}/${endpoint}`, { method: "POST", headers: { Authorization: `Bearer ${process.env.FLUX_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify(body), }); if (!response.ok) throw new Error(`Flux ${response.status}: ${await response.text()}`); return (await response.json()) as T;}const search = await post<{ results: { url: string }[]; usage: Usage }>("search", { query: "sodium-ion battery mass production 2026", max_results: 6, enrich: 0,});const urls = search.results.map((r) => r.url);const read = await post<{ data: Entry[]; errors?: unknown[]; usage: Usage }>("lineage", { documents: urls.map((url) => ({ url })), queries: QUESTIONS,});for (const question of QUESTIONS) { console.log(question); const passages = read.data .filter((e) => e.query === question) .flatMap((e) => e.results.map((p) => ({ p, url: urls[e.document_index] }))) .sort((a, b) => (b.p.score ?? 0) - (a.p.score ?? 0)) .slice(0, 3); for (const { p, url } of passages) { console.log(` ${(p.score ?? 0).toFixed(2)} ${p.enriched_text.trim()}`); console.log(` ${url}`); } console.log();}const errors = read.errors ?? [];const ticks = search.usage.cost_usd_ticks + read.usage.cost_usd_ticks;console.log( `Read ${urls.length - errors.length} of ${urls.length} pages, ${errors.length} unreadable`,);console.log(`Cost: $${(ticks / 1e10).toFixed(4)}`);What it prints
Output
Which companies are mass-producing sodium-ion batteries? 0.99 CATL resolved sodium-ion battery core manufacturing challenge, mass production to start in 2026, company’s Chief Scientist says https://www.reddit.com/r/electricvehicles/comments/1ss8995/catl_resolved_sodiumion_battery_core/ 0.99 "When the supply chain matures, CATL expects vehicles with sodium-ion batteries to feature a range of up to 600 km. https://www.reddit.com/r/electricvehicles/comments/1ss8995/catl_resolved_sodiumion_battery_core/ 0.98 May 30, 2026 8:34 AM CEST https://carnewschina.com/2026/05/30/catl-to-mass-produce-sodium-ion-batteries-in-2026-targets-600-km-range/When does production start? 1.00 CATL resolved sodium-ion battery core manufacturing challenge, mass production to start in 2026, company’s Chief Scientist says https://www.reddit.com/r/electricvehicles/comments/1ss8995/catl_resolved_sodiumion_battery_core/ 1.00 "When the supply chain matures, CATL expects vehicles with sodium-ion batteries to feature a range of up to 600 km. https://www.reddit.com/r/electricvehicles/comments/1ss8995/catl_resolved_sodiumion_battery_core/ 0.98 The Naxtra sodium-ion battery achieved GWh-scale industrialization with full production starting in 2026 https://www.batterytechonline.com/design-manufacturing/how-catl-moved-sodium-ion-batteries-from-lab-chemistry-to-gwh-scale-realityRead 6 of 6 pages, 0 unreadableCost: $0.0057How it works
- Entries are grouped by
query, then passages from every page are ranked byscore. - Cost is the search plus the Lineage request, read from each
usage.cost_usd. A search is a flat price, and Lineage is billed by the tokens it reads. - A request can run up to 200 passes, one per document per question.