{"uid":"cap_aBQar1PEbUYaLKgSQUfop","slug":"fathom-macroeconomic-data-api-series-tags-lookup-c388913b","name":"Fathom Macroeconomic Data API — Series Tags Lookup","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fathom-opal.vercel.app/api/series-tags","method":"POST","headers":{},"bodySchema":{"type":"object","required":["seriesId"],"properties":{"seriesId":{"type":"string","description":"FRED series ID"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"tags":{"type":"array","items":{"type":"object"}},"source":{"type":"string"},"series_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_JrpbJOhN0pLaGQzPwUPEI","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 specific FRED economic data series, given its series ID","exampleAgentPrompt":"What tags are associated with the FRED series UNRATE — I want to know how it's categorized in the macroeconomic database.","exampleUseCases":[{"title":"Classifying an economic indicator","prompt":"Can you look up the tags for the FRED series CPIAUCSL so I can see how the consumer price index inflation series is categorized?"},{"title":"Building a data discovery tool","prompt":"Fetch the taxonomy tags for the FRED series FEDFUNDS — I'm trying to understand what topics and categories the federal funds rate series belongs to."},{"title":"Verifying series metadata for a report","prompt":"Pull the tags associated with FRED series GDP for me — I want to confirm what classifications apply to it before I cite it in my economic analysis."}],"resultDescription":"Returns a JSON object containing an array of tag objects associated with the requested FRED series (each tag describes a classification dimension such as topic, frequency, geography, or source), along with the series ID and the data source name.","failureModes":["Invalid or unknown FRED series ID returns an empty tags array or error","Network timeout from upstream FRED API","Missing required seriesId field returns a validation error","FRED API rate limits or outages propagate as errors","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to discover how a FRED economic time series is classified or tagged — useful for building data catalogs, filtering series by topic or geography, or enriching metadata about a known series. Prefer this over a full series search when you already have the FRED series ID and only need its classification metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:35:18.458Z","isFirstParty":false}