{"uid":"cap_DuE7772Ema9z8T2P8kJae","slug":"fathom-macroeconomic-data-api-series-tags-38bc09f8","name":"Fathom Macroeconomic Data API — Series 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/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_ytGOPGyBeRrhyeVPyQpNK","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":"Retrieves the metadata tags associated with a FRED economic time series by its series ID","exampleAgentPrompt":"What are the FRED metadata tags for the GDP series — can you look up the tags for series ID 'GDP' using Fathom's macroeconomic data API?","exampleUseCases":[{"title":"Categorize an inflation indicator","prompt":"What FRED tags are attached to the CPI series — look up the metadata tags for series ID 'CPIAUCSL' so I can see what categories and themes it belongs to."},{"title":"Explore unemployment series classification","prompt":"Can you fetch the FRED tags for the unemployment rate series 'UNRATE'? I want to understand how it's classified in the FRED database."},{"title":"Audit economic dataset taxonomy","prompt":"Pull the FRED metadata tags for the 10-year Treasury yield series 'DGS10' — I'm building a taxonomy of interest rate indicators and need to know how FRED categorizes it."}],"resultDescription":"Returns an object containing an array of tag objects associated with the specified FRED series (each tag may include name, group_id, notes, created, popularity, and series_count fields), along with the source identifier and the series ID that was queried.","failureModes":["Invalid or unknown FRED series ID returns empty tags array or error","Missing required seriesId field returns validation error","FRED upstream service unavailability causes timeout or 5xx error","Misspelled series ID (e.g. lowercase when uppercase required) returns no results","Rate limiting or payment failure results in 402 or 429 response"],"whenToPreferThis":"Use this endpoint when you need to understand the metadata classification, thematic grouping, or topic tags of a specific FRED economic time series. Prefer this over general series search when you already know the series ID and want to enrich it with tag/category context for filtering, taxonomy building, or dataset auditing. This is more targeted than a full series search and cheaper when you only need tag metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:02.868Z","isFirstParty":false}