# Fathom Macroeconomic Data API — Search

> Fathom Macroeconomic Data API — Search is a paid API for AI agents from fredthom.vercel.app, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-15).

Search 816,000+ FRED economic time series by keyword to find relevant macroeconomic data (GDP, inflation, unemployment, interest rates, etc.)

## Facts

- Endpoint: POST https://fredthom.vercel.app/api/search
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-search-e6a79600
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DnaWNDTsG_K5oYghCzO7D

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fathom-macroeconomic-data-api-search-e6a79600 -d '<json body>'
```

Example prompt: Search the Fathom FRED macroeconomic database for time series related to 'inflation rate' and return the top 5 results so I can see what economic indicators are available.

## When to prefer this

Use this endpoint when you need to discover and identify specific economic time series from the FRED database by keyword before fetching their actual data. Ideal for agents that need to map a natural-language economic concept (e.g. 'core PCE inflation') to a specific FRED series ID. Prefer this over direct FRED API access when using x402 micropayment-enabled infrastructure or when you want a simplified search interface over the full 816,000+ series catalog.

## Known failure modes

- Missing required 'query' field returns a validation error
- Empty or overly generic query may return irrelevant or no series
- Network timeout if FRED upstream is slow or unavailable
- Invalid limit value (non-numeric string) may cause unexpected behavior
- Payment failure (402) if USDC payment is not properly attached

## How this service works

Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.

## Output

A JSON object containing the original query string, total count of matching series, the source identifier ('FRED'), and an array of economic time series objects matching the search keywords — each series likely includes metadata such as series ID, title, frequency, units, and observation dates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max results (default: 10)"
  },
  "query": {
   "type": "string",
   "description": "Search keywords (e.g. 'inflation rate', 'housing starts')"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source"
 ],
 "properties": {
  "count": {
   "type": "number"
  },
  "query": {
   "type": "string"
  },
  "series": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "source": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fathom-macroeconomic-data-api-search-e6a79600/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fredthom.vercel.app](https://www.zero.xyz/host/fredthom.vercel.app/llms.txt)