{"uid":"cap_SXiY1zmRDCHLkDw1Tfhqf","slug":"fathom-macroeconomic-data-api-tag-series-search-75995a75","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://fsthum.vercel.app/api/tag-series?utm_source=zero.xyz","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.4","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.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ogMhVCUtzgwYYRABrjIg9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a list of FRED economic time series that match a given tag (e.g. 'gdp', 'inflation', 'monthly', 'nsa'), returning up to a configurable number of results.","exampleAgentPrompt":"Search FRED for all economic time series tagged 'inflation' and give me up to 30 results.","exampleUseCases":[{"title":"Discover inflation data series","prompt":"Pull all FRED economic time series tagged 'inflation' — I want to see what datasets are available, give me up to 25 results."},{"title":"Find monthly GDP datasets","prompt":"Search for macroeconomic time series tagged 'monthly' and 'gdp' on FRED — show me the top 20 so I can pick which one to analyze."},{"title":"Explore not-seasonally-adjusted unemployment data","prompt":"Find me all FRED series tagged 'nsa' related to unemployment — I need not-seasonally-adjusted figures for my economic model, return up to 15 results."}],"resultDescription":"Returns a JSON object containing the tag used for the query, an array of matching FRED economic time series objects (each with series metadata), and the data source identifier. The series array contains structured information about each matching dataset.","failureModes":["Invalid or unrecognized tag returns empty series array","Missing required 'tag' field causes a 400/validation error","Limit parameter ignored or out-of-range may default to 20","FRED upstream service unavailability causes 502/timeout","Overly broad tags may return truncated or generic results"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate FRED economic time series by topic tag before fetching actual data values. Ideal for building a catalog of available datasets, letting users browse economic indicators by category, or identifying the right series ID to query next. Prefer this over direct series lookup when you don't know the exact FRED series ID but know the economic concept or frequency (e.g. 'gdp', 'monthly', 'inflation').","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:10:14.002Z","isFirstParty":false,"canonicalSlug":"fathom-macroeconomic-data-api-tag-series-search-75995a75"}