{"uid":"cap_iPA169dAC2L5v8b1hMlEa","slug":"fathom-macroeconomic-data-api-category-tags-b6c5fd12","name":"Fathom Macroeconomic Data API — Category Tags","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fathoms.vercel.app/api/category-tags","method":"POST","headers":{},"bodySchema":{"type":"object","required":["categoryId"],"properties":{"categoryId":{"type":"string","description":"FRED category ID"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"tags":{"type":"array","items":{"type":"object"}},"source":{"type":"string"},"category_id":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jfeF90USAlNHZbintHgHL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the tags associated with a FRED economic data category, enabling discovery and filtering of time series within that category","exampleAgentPrompt":"What tags are associated with FRED category 32992 (the Money, Banking, and Finance category)? I want to understand what topics are covered so I can narrow down which economic time series to pull.","exampleUseCases":[{"title":"Exploring inflation data categories","prompt":"I'm looking at FRED category 32455 which covers consumer price indexes — can you pull all the tags for that category so I can see how the data is classified and find the right series for CPI inflation analysis?"},{"title":"Filtering unemployment time series","prompt":"Before I start pulling unemployment data, can you grab all the tags for FRED category 33509 so I can figure out which filters to apply to narrow down to U.S. monthly seasonally adjusted series?"},{"title":"Building an economic dashboard topic map","prompt":"I need to map out what economic topics are covered in FRED category 106 on interest rates — can you retrieve all the tags for that category so I can categorize them for my macroeconomic dashboard?"}],"resultDescription":"Returns an array of tag objects associated with the specified FRED category, along with the data source identifier and the category ID that was queried. Each tag object describes a topic, frequency, geography, or other classification attribute that applies to time series within that category.","failureModes":["Invalid or non-existent categoryId returns an empty tags array or error","FRED API upstream outage causes failure or delayed response","Malformed request body missing required categoryId field returns a 400 error","Rate limiting or payment verification failure returns a 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need to discover, enumerate, or filter the classification tags for a specific FRED economic category before pulling actual time series data. It is ideal for building metadata-driven navigation of the FRED data catalog, constructing filtered search queries, or understanding what subcategories and topic dimensions exist within a given category. Prefer this over general FRED search when you already have a category ID and need to understand its taxonomy.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:32:56.945Z","isFirstParty":false}