# Fathom Macroeconomic Data API — Search Tags

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

Search and retrieve tag metadata from 816,000+ FRED-powered economic time series, enabling discovery of relevant macroeconomic data categories.

## Facts

- Endpoint: POST https://fathoms.vercel.app/api/search-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-search-tags-93ab8aac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mbIXh3QHnODyikWjk9iNZ

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-93ab8aac -d '<json body>'
```

Example prompt: Search the Fathom macroeconomic data API for tags related to 'inflation' and return up to 10 results so I can see what economic series categories are available.

## When to prefer this

Use this endpoint when you need to discover or browse the taxonomy of economic data tags available in the FRED database before fetching actual time series data. It is ideal for exploratory research to identify which categories and labels exist for a given macroeconomic topic, acting as a first step before querying specific series.

## Known failure modes

- Missing required 'query' field returns an error
- Empty query string may return zero tags
- Invalid limit value (non-numeric string) may cause unexpected behavior
- Network timeout if FRED upstream is slow
- Zero results for very niche or misspelled keywords

## 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 a JSON object containing an array of tag objects matching the search keyword, the original query string, and the data source identifier. Each tag object represents a metadata category used to classify 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-93ab8aac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fathoms.vercel.app](https://www.zero.xyz/host/fathoms.vercel.app/llms.txt)