# Fathom Macroeconomic Data API — Tags Endpoint

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

Retrieves and searches the list of available economic data tags (categories/labels) from the FRED-powered macroeconomic database

## Facts

- Endpoint: POST https://frederalfathom.vercel.app/api/tags?utm_source=zero.xyz
- Price: $0.35/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fathom-macroeconomic-data-api-tags-endpoint-bb8cde99
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LssXPiYF66YbfzWtJBj3T

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-endpoint-bb8cde99 -d '<json body>'
```

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

## When to prefer this

Use this endpoint when you need to discover what economic data categories or labels are available before querying specific time series. It is the right starting point for navigating the FRED-powered Fathom database — particularly when the user's topic is vague and you need to identify the correct tag/category before fetching actual economic data. Prefer this over directly querying series data when you do not yet know the exact series ID or tag name.

## Known failure modes

- Empty results if search keyword matches no tags
- Invalid limit parameter type may cause errors
- Network timeout on vercel.app cold starts
- Malformed request body returns error response
- No tags returned if database is unreachable

## 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 representing available economic data categories/labels in the FRED database, along with a source identifier string. Each tag object can be used to navigate or filter the broader dataset of 816,000+ economic time series.

## 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-endpoint-bb8cde99/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from frederalfathom.vercel.app](https://www.zero.xyz/host/frederalfathom.vercel.app/llms.txt)