Search titles, abstracts, subjects, authors and report numbers across all sources.

Args:
    query: Keywords. Quote phrases ("driver improvement"); trailing * = prefix;
        column prefixes work: title:pedestrian, authors:lynn, report_numbers:"813 097".
    year_min / year_max: Inclusive publication-year filter.
    collection: Substring filter on collection name (see list_collections), e.g. "NHTSA",
        "VTI", "BASt", "World Bank", "CEPAL", "TRID", "PubMed".
    doc_type: Substring filter on document type, e.g. "Tech Report", "Dataset".
    source: Comma-separated id prefixes to restrict to, e.g. "dot,vti" (dot = ROSA-P,
        vti, bast, wbokr, ipea, cepal, openalex, cinii, pubmed, trid).
    limit: Max hits (1-100). offset: for paging.
    mode: "hybrid" (default: keyword BM25 fused with semantic vectors when an embedding
        index exists), "keyword", or "semantic" (meaning-based, cross-language). Semantic
        results are capped at 50% from any one source unless `source`/`collection` is
        set; use `source` to search one corpus by meaning. ``mode_used`` says what ran.
Returns ranked hits; ``match_mode`` says whether all query terms matched (all_terms),
the hit came from the any-term fallback, or from the semantic index.

Full metadata record for one report. Accepts 'dot:93144', '93144', the OAI identifier, or the ROSA-P landing URL. Includes every raw Dublin Core field.

Resolve the report's PDF on ROSA-P, extract its text and return it (cached locally after the first call). Page through long documents with offset. Text is marked with [[page N]] separators. Scanned PDFs return status 'no_text'.

Collections (ROSA-P relation.isPartOf values) with record counts, plus document types. ROSA-P's OAI-PMH endpoint exposes no OAI sets, so these are derived from the harvested metadata and are what the collection filter matches against.

Record counts per source, last harvest time/status and notes, coverage by year. If a source's last run is not 'complete' its part of the index may be partial.

Exact lookup by DOI, PMID, report number (e.g. "DOT HS 813 097"), transport-lit id, or landing URL. Use this instead of search when you already have an identifier.

Records similar to a given one (by title and subject terms), across all sources.

Export records as RIS (Zotero/EndNote/Mendeley) or BibTeX. Pass transport-lit ids.

Search inside the PDF text that get_fulltext has already extracted and cached (only documents someone fetched before). Returns snippets with [term] markers.

Records that entered the index in the last N days (from the weekly incremental harvests), newest first, with counts by source. The raw material for a digest.

Works a record cites (its reference list), via OpenAlex, cached locally. Each entry carries record_id when the cited work is itself in this index. match says how the record was matched to OpenAlex (openalex, doi, pmid, or title).

Works that cite a record, via OpenAlex, cached locally (refreshed after 90 days). only_in_index=True returns just citing works that are in this index — 'what has built on this report'. cited_by_count_openalex is OpenAlex's total.