{"uid":"cap_xielYAZdQE_phWZXmuc-_","slug":"fathom-macroeconomic-data-api-tag-series-search-95a0a419","name":"Fathom Macroeconomic Data API — Tag Series Search","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/tag-series","method":"POST","headers":{},"bodySchema":{"type":"object","required":["tag"],"properties":{"tag":{"type":"string","description":"Tag name (e.g. gdp, monthly, inflation, nsa)"},"limit":{"type":"string","description":"Max results (default: 20)"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"tag":{"type":"string"},"series":{"type":"array","items":{"type":"object"}},"source":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0L7RlH7kT-T5gUn9I7h33","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of FRED economic time series matching a given tag (e.g. 'gdp', 'inflation', 'monthly', 'nsa')","exampleAgentPrompt":"Can you search the Fathom FRED-powered API for all economic time series tagged 'inflation' and show me up to 30 results?","exampleUseCases":[{"title":"Research CPI inflation data series","prompt":"Search for all FRED economic time series tagged 'inflation' and give me a list of up to 25 series I can pull data from."},{"title":"Find monthly unemployment indicators","prompt":"I need to see what monthly unemployment time series are available in FRED — can you search Fathom for series tagged 'monthly' with a limit of 20?"},{"title":"Discover NSA GDP economic series","prompt":"Pull up all FRED series tagged 'nsa' related to GDP so I can find not-seasonally-adjusted national output data — give me up to 30 results."}],"resultDescription":"Returns a JSON object containing the tag name queried, an array of matching FRED economic time series objects (each with series metadata such as ID, title, frequency, units, and observation dates), and a source attribution string. The number of series returned is capped by the optional limit parameter (default 20).","failureModes":["Unknown or misspelled tag returns empty series array","Missing required 'tag' field returns validation error","Limit parameter as non-numeric string may cause unexpected defaults","FRED upstream outage results in failed or stale response","Rate limiting or payment failure (x402) blocks access"],"whenToPreferThis":"Use this endpoint when you need to discover which FRED economic time series exist under a particular topic or tag — ideal for browsing or enumerating available datasets before fetching actual data values. Prefer this over a direct series lookup when the user does not yet know the specific FRED series ID and wants to explore what is available under a broad macroeconomic theme like 'gdp', 'inflation', or 'unemployment'.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:48:06.100Z","isFirstParty":false}