Skip to main content
Valyu gives one search interface over state-of-the-art web search plus specialised, proprietary, and open data sources spanning research, finance, life sciences, genomics, law, and more. This page is a tool manifest: a single place for an AI agent (or its developer) to learn what exists and exactly how to target it. You have three ways to control which sources answer a query:

Let us route

Call /search with no source filter and Valyu selects the most relevant sources automatically.

Target by id

Pass dataset ids (e.g. valyu/valyu-sec-filings) to included_sources to query exactly those datasets.

Target by preset

Pass a preset name (e.g. finance, genomics) to included_sources to query a whole family at once.
Integrating raw Search? If you are building knowledge work on top of these sources, consider DeepResearch instead - a cost-effective autonomous agent built on top of the same search engine that plans, runs, verifies, and writes a cited report for you. It uses every source below (including DeepResearch-only signals) without you orchestrating the calls.

How to target sources

The included_sources array on /search (and the underlying tooling in Answer and DeepResearch) accepts any mix of:
dataset id
string
A specific dataset, e.g. valyu/valyu-patents. Combine multiple ids to query several datasets together.
preset name
string
A family shortcut: academic, finance, patent, transportation, politics, legal, health, genomics, chemistry, physics, pulse, cybersecurity, environment, automotive, compliance, medical. Expands to every dataset in that family.
collection:NAME
string
An org-scoped saved source set. Create reusable bundles of sources in the platform, then target them by name, e.g. collection:diligence-stack.
web
string
The live web. Pass web to force web search alongside (or instead of) proprietary datasets.
url / domain
string
A specific URL or domain to bias web results toward, e.g. arxiv.org.
Use excluded_sources to remove a source, and source_biases (an object of source -> -5..+5) to soft-rank without hard filtering.
from valyu import Valyu

valyu = Valyu()

# By id
valyu.search(
    "kinase inhibitor selectivity",
    included_sources=["valyu/valyu-chembl", "valyu/valyu-pubchem"],
)

# By preset - whole chemistry family at once
valyu.search(
    "EGFR inhibitor resistance mechanisms",
    included_sources=["chemistry"],
)

# By saved collection
valyu.search(
    "Q3 earnings drivers for semiconductor names",
    included_sources=["collection:diligence-stack"],
)
curl -X POST https://api.valyu.ai/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "EGFR inhibitor resistance mechanisms",
    "included_sources": ["chemistry"]
  }'

How access works

All plans include web search and open academic sources (arXiv, PubMed). Specialised and proprietary sources (SEC, patents, drug discovery, genomics, and the rest) unlock as you move up plans - and a plan also lowers your cost per credit. During the free trial every source is available so you can test before you commit. See pricing for the full source-to-plan breakdown, or request access to a specific dataset above your plan.
Two availability concepts to know:
  • Plan-gated - a source unlocks at a given plan (or with free trial credits). Marked below as the plan that unlocks it.
  • Access mode - whether a source answers raw /search (and Answer) calls, marked Search + Answer + DeepResearch, or is served only inside DeepResearch, marked DeepResearch only.
DeepResearch-only sources can’t be called via /v1/search. Passing their ids to included_sources on /search returns no results. To use them, run a DeepResearch task (POST /v1/deepresearch/tasks) with the topic in the query; the agent pulls these signals automatically, and you can name the source to nudge it (e.g. “…using OFAC SDN and UK HMT sanctions lists”). Every other source below answers raw Search, Answer, and DeepResearch.
Whole families (every source) - not callable via /v1/search:
  • Transportation - UK National Rail, global ship tracking (AIS)
  • Environment & geo - NWS Weather, OpenAQ, FEMA Disasters, NASA EONET, Open-Meteo (+ air, marine), OSM Nominatim
  • Automotive - NHTSA vPIC, Recalls, Complaints, Investigations
  • Compliance & sanctions - OFAC SDN / non-SDN, UN, UK HMT, Swiss SECO, Australia DFAT, INTERPOL Red, US CSL
  • Pulse signals - GDELT, Wikipedia Pageviews, Crossref Velocity, PyPI / npm / crates.io downloads
Specific datasets inside otherwise-searchable families:
  • Finance - short-seller reports, buyside letters & pitches, semiconductor-industry news, congressional research (CRS), legal & regulatory news, FDIC BankFind
  • Health - NPI registry, WHO ICD, openFDA device events, openFDA food recalls, CDC wastewater (NWSS)
Everything else - web, academic, SEC, patents, chemistry, genomics, economics, prediction markets, UK case law / legislation / Parliament, physics, cybersecurity, and the searchable health/finance datasets - answers raw Search and Answer too.

Catalog

Sizes and identifiers are listed in full on Data Coverage. Below is the agent-targeting view: ids, the preset that selects each family, and the plan that unlocks it.

Web Search + Answer + DeepResearch

TargetPresetUnlocks on
web-Every plan
Live web search across news, docs, and the open internet. Combine web with any proprietary ids to blend fresh web context into a domain search.

Academic Search + Answer + DeepResearch

Preset: academic • See Academic use cases
Source idDescriptionUnlocks on
valyu/valyu-arxivPhysics, CS, maths, quant finance, economics preprintsPay-as-you-go
valyu/valyu-pubmedBiomedical and life-sciences literaturePay-as-you-go
valyu/valyu-biorxivLife-sciences preprintsRidiculously Cheap
valyu/valyu-medrxivClinical / health preprintsRidiculously Cheap
valyu/valyu-chemrxivChemistry preprintsComfortably Pro
wiley/wiley-finance-papersLicensed Wiley finance journalsSerious Business
wiley/wiley-finance-booksLicensed Wiley finance booksSerious Business

Finance & markets Search + Answer + DeepResearch

Preset: finance • See Finance use cases
Source idDescriptionUnlocks on
valyu/valyu-stocks, valyu/valyu-stocks-USGlobal and US equities (75 exchanges)Ridiculously Cheap
valyu/valyu-cryptoCryptocurrency prices and market capRidiculously Cheap
valyu/valyu-forexFX pairsRidiculously Cheap
valyu/valyu-polymarket, valyu/valyu-kalshiPrediction marketsRidiculously Cheap
valyu/valyu-commoditiesCommodity futuresComfortably Pro
valyu/valyu-market-movers-USTop gainers / losers / most activeComfortably Pro
valyu/valyu-etfs, valyu/valyu-fundsETFs and mutual fundsSerious Business
valyu/valyu-earnings-US, valyu/valyu-earnings-calendar-USEarnings and calendarSerious Business
valyu/valyu-balance-sheet-US, valyu/valyu-income-statement-US, valyu/valyu-cash-flow-USFinancial statementsSerious Business
valyu/valyu-dividends-US, valyu/valyu-statistics-US, valyu/valyu-insider-transactions-USDividends, key stats, insider tradesSerious Business
Investment-research signals available inside DeepResearch only (not callable via raw /search): valyu/valyu-short-seller-reports, valyu/valyu-buyside-letters-pitches, valyu/valyu-semiconductor-industry-news, valyu/valyu-congressional-research, valyu/valyu-legal-regulatory-news, valyu/valyu-fdic-bankfind DeepResearch only

SEC filings Search + Answer + DeepResearch

See Finance use cases
Source idDescriptionUnlocks on
valyu/valyu-sec-filings10-K, 10-Q, 8-K, S-4, DEF 14A, Form 10, SC TO-T, SC 14D9, 13F-HR, SC 13D, SC 13GComfortably Pro

Patents Search + Answer + DeepResearch

Preset: patent • See Finance use cases
Source idDescriptionUnlocks on
valyu/valyu-patentsUSPTO (US), full text with figures. Index updated weeklySerious Business
valyu/valyu-patents-epoEPO (Europe), full text with figuresSerious Business

Chemistry & drug discovery Search + Answer + DeepResearch

Preset: chemistry • See Healthcare use cases
Source idDescriptionUnlocks on
valyu/valyu-chemblBioactive molecules, assays, IC50/Ki/Kd/EC50Serious Business
valyu/valyu-pubchem100M+ chemical structures and propertiesSerious Business
valyu/valyu-open-targetsTarget-disease associations and validationSerious Business

Genomics Search + Answer + DeepResearch

Preset: genomics • See Healthcare use cases 19 NCBI databases. Use the genomics preset to query all at once, or target individual ids: valyu/valyu-ncbi-gene, valyu/valyu-ncbi-nucleotide, valyu/valyu-ncbi-protein, valyu/valyu-ncbi-snp, valyu/valyu-ncbi-clinvar, valyu/valyu-ncbi-geo, valyu/valyu-ncbi-taxonomy, valyu/valyu-ncbi-structure, valyu/valyu-ncbi-sra, valyu/valyu-ncbi-biosample, valyu/valyu-ncbi-genome, valyu/valyu-ncbi-assembly, valyu/valyu-ncbi-bioproject, valyu/valyu-ncbi-cdd, valyu/valyu-ncbi-dbgap, valyu/valyu-ncbi-dbvar, valyu/valyu-ncbi-medgen, valyu/valyu-ncbi-gtr, valyu/valyu-ncbi-protclust. Unlocks on Serious Business.

Health Mixed access

Preset: health • See Healthcare use cases Most health sources answer raw Search; a few registries and recall feeds are DeepResearch-only.
Source idDescriptionUnlocks onAccess
valyu/valyu-clinical-trialsClinicalTrials.gov studiesComfortably ProSearch + Answer + DeepResearch
valyu/valyu-drug-labelsFDA drug labels / DailyMedComfortably ProSearch + Answer + DeepResearch
valyu/valyu-who-health-dataWHO global health statisticsComfortably ProSearch + Answer + DeepResearch
valyu/valyu-nih-grantsNIH research fundingSerious BusinessSearch + Answer + DeepResearch
valyu/valyu-openfda-drug-eventsopenFDA drug adverse eventsSerious BusinessSearch + Answer + DeepResearch
valyu/valyu-npi-registryUS healthcare provider registrySerious BusinessDeepResearch only
valyu/valyu-who-icdWHO ICD-10 / ICD-11 codesSerious BusinessDeepResearch only
valyu/valyu-openfda-device-eventsopenFDA device adverse eventsSerious BusinessDeepResearch only
valyu/valyu-openfda-food-recallsFDA food recallsSerious BusinessDeepResearch only
valyu/valyu-cdc-nwssCDC wastewater surveillanceSerious BusinessDeepResearch only

Economic data Search + Answer + DeepResearch

See Finance use cases
Source idDescriptionUnlocks on
valyu/valyu-blsUS Bureau of Labor StatisticsComfortably Pro
valyu/valyu-worldbank-indicatorsWorld Bank development indicatorsComfortably Pro
valyu/valyu-fredFederal Reserve Economic DataSerious Business
valyu/valyu-imfIMF macro and financial indicatorsSerious Business
valyu/valyu-usaspendingUS federal spendingSerious Business
valyu/valyu-destatis-laborGerman labour-market statisticsSerious Business
Preset: legal
Source idDescriptionUnlocks on
valyu/valyu-uk-case-lawUK case law and judgmentsSerious Business
valyu/valyu-uk-legislationUK primary and secondary legislationSerious Business
Legal & regulatory news (valyu/valyu-legal-regulatory-news) is DeepResearch only and listed under Finance above.

Politics Search + Answer + DeepResearch

Preset: politics
Source idDescriptionUnlocks on
valyu/valyu-uk-parliamentUK Parliament debates, written questions, member activitySerious Business
Congressional Research Service / CRS (valyu/valyu-congressional-research) is DeepResearch only and listed under Finance above.

Transportation DeepResearch only

Preset: transportation • See Data Coverage
These sources are available through DeepResearch, not the Search/Answer API. Run a DeepResearch task with your transportation question in the query.
Source idDescriptionUnlocks on
valyu/valyu-uk-national-railLive UK train departures, delays, cancellationsSerious Business
valyu/valyu-global-ship-trackingGlobal vessel positions ()Serious Business

Physics Search + Answer + DeepResearch

Preset: physics
Source idDescriptionUnlocks on
valyu/valyu-cern-opendataCERN open research data, high-energy physicsSerious Business

Cybersecurity Search + Answer + DeepResearch

See Data Coverage
Source idDescriptionUnlocks on
valyu/valyu-cisa-kevCISA Known Exploited VulnerabilitiesSerious Business
valyu/valyu-nvd-cveNVD CVE records with severity scoresSerious Business
valyu/valyu-epssExploit Prediction Scoring SystemSerious Business
valyu/valyu-mitre-attackMITRE ATT&CK tactics and techniquesSerious Business

Compliance & sanctions DeepResearch only

See Data Coverage
These sources are available through DeepResearch, not the Search/Answer API. Run a DeepResearch task and name the lists you need in the query (e.g. “screen Acme Corp against OFAC SDN, UN, and UK HMT sanctions”).
Source idDescriptionUnlocks on
valyu/valyu-ofac-sdn, valyu/valyu-ofac-consolidatedOFAC SDN and consolidated (non-SDN) listsSerious Business
valyu/valyu-un-sanctionsUN Security Council sanctionsSerious Business
valyu/valyu-uk-hmt-sanctionsUK HM Treasury sanctionsSerious Business
valyu/valyu-ch-seco-sanctions, valyu/valyu-au-dfat-sanctionsSwitzerland (SECO), Australia (DFAT)Serious Business
valyu/valyu-interpol-redINTERPOL Red NoticesSerious Business
valyu/valyu-us-cslUS Consolidated Screening ListSerious Business

Environment & geo DeepResearch only

See Data Coverage
These sources are available through DeepResearch, not the Search/Answer API. Run a DeepResearch task with your weather, air-quality, disaster, or geocoding question in the query.
Source idDescriptionUnlocks on
valyu/valyu-nws-weatherUS National Weather Service forecasts and alertsSerious Business
valyu/valyu-openaqGlobal air-quality measurementsSerious Business
valyu/valyu-fema-disastersFEMA disaster declarationsSerious Business
valyu/valyu-nasa-eonetNASA natural-event trackingSerious Business
valyu/valyu-open-meteo, valyu/valyu-open-meteo-air-quality, valyu/valyu-open-meteo-marineOpen-Meteo weather, air-quality, and marine forecastsSerious Business
valyu/valyu-nominatimOSM Nominatim geocoding / place lookupSerious Business

Automotive DeepResearch only

See Data Coverage
These sources are available through DeepResearch, not the Search/Answer API. Run a DeepResearch task with your vehicle, recall, or complaint question in the query.
Source idDescriptionUnlocks on
valyu/valyu-nhtsa-vpicVIN decode and vehicle identificationSerious Business
valyu/valyu-nhtsa-recallsVehicle safety recallsSerious Business
valyu/valyu-nhtsa-complaintsConsumer safety complaintsSerious Business
valyu/valyu-nhtsa-investigationsNHTSA defect investigationsSerious Business

Pulse signals DeepResearch only

See Data Coverage
These sources are available through DeepResearch, not the Search/Answer API. Run a DeepResearch task and name the signal in the query (e.g. “PyPI and npm download trends for vector-database clients over the last 12 months”).
Source idDescription
valyu/valyu-gdeltGlobal news and events graph
valyu/valyu-wikipedia-pageviewsAttention / demand proxy
valyu/valyu-crossref-velocityResearch publication velocity
valyu/valyu-pypi-downloads, valyu/valyu-npm-downloads, valyu/valyu-crates-ioPackage-ecosystem download trends

Discover sources at runtime

Agents should not hardcode this list. Query the Datasources API to discover what is available, with example_queries (optimised for few-shot prompting), response_schema, and pricing.cpm per source:
import requests

datasources = requests.get(
    "https://api.valyu.ai/v1/datasources",
    headers={"x-api-key": "YOUR_API_KEY"},
).json()["datasources"]
curl https://api.valyu.ai/v1/datasources \
  -H "x-api-key: YOUR_API_KEY"
Filter to a category with ?category=markets, or list categories with counts at /v1/datasources/categories. This turns Valyu from “an API you need to know” into “an API that teaches itself to your agent.”

Targeting DeepResearch-only sources

Sources badged DeepResearch only are not callable from /v1/search - passing their ids to included_sources returns no results. Put the topic in a DeepResearch task instead and, optionally, name the source to steer it. The access mode lives in each dataset’s access_modes field from /v1/datasources, so agents can check it at runtime.
from valyu import Valyu

valyu = Valyu()

task = valyu.deepresearch.create(
    query="Screen Acme Shipping against OFAC SDN, UN, and UK HMT sanctions lists and summarise any matches.",
)
report = valyu.deepresearch.wait(task.id)
curl -X POST https://api.valyu.ai/v1/deepresearch/tasks \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Track current vessel positions for Maersk container ships near the Suez Canal using global ship tracking."
  }'

Teach your agent to discover and target Valyu data sources correctly.

Open in Cursor

Data Coverage

Full registry with sizes and update frequencies

Search API

Use these sources with the Search endpoint

DeepResearch

Autonomous agent over every source

Pricing

Which plan unlocks which sources