# Fathom Macroeconomic Data API — Search Tags

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

Search and discover tags/categories within FRED's 816,000+ macroeconomic economic time series database

## Facts

- Endpoint: POST https://fredthom.vercel.app/api/search-tags
- Price: $0.35/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-tags-68ffd25f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Hblx0B7lMLJZMaJ8ahAE2

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-tags-68ffd25f -d '<json body>'
```

Example prompt: Search the Fathom FRED macroeconomic database for tags related to 'inflation' and return up to 10 results so I can find the right economic series to explore.

## When to prefer this

Use this endpoint when you need to discover or browse the taxonomy of tags available in FRED's macroeconomic database before fetching actual time series data. This is the right choice when you know a keyword (e.g. 'GDP', 'unemployment') but need to find the correct tag identifiers to use in subsequent data queries.

## Known failure modes

- Missing required 'query' field returns validation error
- No matching tags found returns empty tags array
- Invalid limit format may fall back to default of 20
- Service unavailable returns error from Vercel hosting

## How this service works

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

## Output

Returns an array of tag objects matching the search keyword, along with the original query string and the data source identifier. Tags help navigate and filter the 816,000+ FRED economic time series.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max results (default: 20)"
  },
  "query": {
   "type": "string",
   "description": "Search keyword"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fathom-macroeconomic-data-api-search-tags-68ffd25f/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)