{"uid":"cap_UHeD1djVN_ea6DcTP8lGi","slug":"fathom-macroeconomic-data-api-category-tags-b87ac165","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://fsthum.vercel.app/api/category-tags?utm_source=zero.xyz","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.35","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.35/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kVJqMtvgtS1uwSUM4AFE6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.35","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 specific FRED economic data category, enabling discovery and filtering of economic time series within that category.","exampleAgentPrompt":"What tags are available for FRED category 32992? I want to see how I can filter the time series within that category.","exampleUseCases":[{"title":"Explore GDP data category tags","prompt":"Can you pull up all the tags for the FRED national accounts category — I'm trying to figure out what filters I can use to narrow down GDP-related time series."},{"title":"Research inflation indicator filters","prompt":"Look up the tags associated with FRED category 9 — I want to see what labels they use to organize inflation and price index data before I pull specific series."},{"title":"Build economic dashboard filter UI","prompt":"Fetch all the tags for FRED category 32455 so I can populate a filter dropdown for users browsing unemployment and labor market indicators."}],"resultDescription":"An object containing the category ID, the source ('FRED'), and an array of tag objects associated with that category — each tag typically includes a name, group ID, and series count that can be used to filter or discover time series within the category.","failureModes":["Invalid or non-existent FRED category ID returns empty tags array or error","Network timeout on the Vercel deployment under high load","FRED upstream API rate limits or outages causing failed lookups","Missing required categoryId field returns 400 validation error","Payment of 0.35 USDC not completed causes 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need to discover the tagging taxonomy for a specific FRED economic category — ideal for building filter interfaces, exploring what labels organize a category's time series, or programmatically narrowing down which economic indicators to fetch. Prefer this over a general FRED series search when you already know the category and want metadata about how its data is organized.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:12:06.304Z","isFirstParty":false,"canonicalSlug":"fathom-macroeconomic-data-api-category-tags-b87ac165"}