Flux logo
Flux
Docs
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.

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.0057

How it works

  • Entries are grouped by query, then passages from every page are ranked by score.
  • 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.

Next steps