# Fathom Macroeconomic Data API — Tags Search

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

Search and retrieve available tags from 816,000+ FRED economic time series to discover categorized macroeconomic data topics

## Facts

- Endpoint: POST https://fredfathom.vercel.app/api/tags
- Price: $0.04/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-tags-search-d8717abf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TwRpvuMSkna3ILrfeLzxc

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-tags-search-d8717abf -d '<json body>'
```

Example prompt: Search the Fathom FRED data API for tags related to 'inflation' and show me up to 20 results so I can figure out which economic series to pull.

## When to prefer this

Choose this endpoint when you need to discover or browse available FRED data categories before fetching actual economic time series data. It is ideal as a first step in a two-stage workflow: search tags here, then use the relevant tag to fetch specific series. Prefer this over direct series lookup when the exact tag name is unknown or when you want to explore what macroeconomic topics are covered.

## Known failure modes

- No tags found for obscure or misspelled search keywords — returns empty array
- Rate limiting or payment failure if x402 payment is not properly handled — returns payment required error
- Invalid limit parameter format — may return default 50 results or error
- Service unavailable if FRED upstream is down — returns 5xx error

## How this service works

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

## Output

An array of tag objects from the FRED database matching the search keyword, along with a source attribution string. Each tag represents a category or label applied to one or more economic time series, enabling the caller to identify which tags to use for subsequent data queries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "string",
   "description": "Max results (default: 50)"
  },
  "search": {
   "type": "string",
   "description": "Filter tags by keyword"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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