The analyst still hunts for the visual.
A text answer and source link may leave someone to find the right chart, series, and period by hand.
For research agents
Let the agent find the chart. Let the analyst verify it.
Keep analysts in their existing research workflow. An agent can call the hosted search endpoint for public visual candidates, then show source details for an analyst to review before one goes into a memo or report.
Available today: a public, read-only hosted search endpoint for the deployed public index. Private and locally ingested evidence, the CLI, other HTTP API routes, and stdio MCP require a local workspace.
RESEARCH WORKFLOW API / CLI
- 01Analyst asksInside the research product
- 02App searches
POST /v1/search - 03Candidates returnVisual + source context
- 04Analyst reviewsBefore using it
Where it fits
The analyst keeps the workflow they already use.
The agent can present chart candidates to review.
The response can include an asset, FRED series ID, source page, data link, description, and recorded rights label. The analyst still decides which result fits.
A real search example
One question. Five candidates. Source details attached.
This request was checked against the current indexed FRED records. The three shown are the first three returned; compare their series and geography before using one.
Analyst asks
“Find an official chart of the U.S. unemployment rate for a macro research note.”HTTP request body
POST
/v1/search{
"query": "US unemployment rate UNRATE",
"corpus": "macro-public-data",
"candidateLimit": 5
}Standard deterministic text search over the selected corpus. The request asks for five candidates.
Response · FRED3 shown of 5
CANDIDATE 01 · CHART
Unemployment Rate
Series UNRATE
Unemployment Rate. Native FRED chart with machine-readable observations, source notes, units, and frequency available from the linked series page.
- Publisher
- Federal Reserve Bank of St. Louis · FRED
- Rights recorded
- Public domain; citation requested
CANDIDATE 02 · CHART
Unemployment Rate in St. Louis, MO-IL (MSA)
Series STLUR
Unemployment Rate in St. Louis, MO-IL (MSA). Native FRED chart with machine-readable observations, source notes, units, and frequency available from the linked series page.
- Publisher
- Federal Reserve Bank of St. Louis · FRED
- Rights recorded
- Public domain; citation requested
CANDIDATE 03 · CHART
Unemployment Rate
Series UNRATENSA
Unemployment Rate. Native FRED chart with machine-readable observations, source notes, units, and frequency available from the linked series page.
- Publisher
- Federal Reserve Bank of St. Louis · FRED
- Rights recorded
- Public domain; citation requested
These are retrieval candidates, not verified conclusions. Check series definition, geography, observation period, and source before citing or redistributing a visual.
Developer path
Connect to hosted search.
Send a JSON request to the public endpoint to retrieve candidates from the public index. Run the workspace locally when you need private or locally ingested evidence.
- 01
Review public coverage
Check the corpus counts in the deployed public index manifest.
GET /evidence-index-manifest.json - 02
Run a search
Send a query and optional corpus slug to the hosted read-only endpoint.
POST /v1/search - 03
Return candidates for review
Show the visual alongside its source link and available context; let the analyst choose whether it fits.
Read the API reference →