{"uid":"cap_HbiPQpMmhIo9Uakzwh0zk","slug":"fathom-macroeconomic-data-api-tag-series-search-eea81ceb","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://fathom-opal.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_4yVSBPtbK6bd3YN6qGOGU","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 filtered by a given tag (e.g. 'gdp', 'inflation', 'monthly', 'nsa')","exampleAgentPrompt":"Search Fathom's FRED-powered macroeconomic database for all time series tagged 'inflation' and show me up to 30 results.","exampleUseCases":[{"title":"Discover inflation data series","prompt":"Find me all the FRED economic time series tagged 'inflation' — give me up to 25 results so I can pick the right one to track CPI trends."},{"title":"Browse monthly economic indicators","prompt":"Pull up a list of macroeconomic series tagged 'monthly' from Fathom's FRED data API, limit it to 20 results."},{"title":"Explore unemployment time series","prompt":"I need to find FRED time series related to unemployment — search Fathom's API for anything tagged 'unemployment' and return up to 30 series."}],"resultDescription":"Returns a JSON object containing the queried tag name, an array of matching FRED economic time series objects (each with series metadata such as ID, title, frequency, units, and observation range), and a source field indicating the data provider.","failureModes":["Missing required 'tag' field returns a validation error","Unknown or misspelled tag returns an empty series array","Limit parameter passed as non-numeric string may cause unexpected results","Rate limiting or payment failure (x402) blocks the request","FRED upstream outage may cause downstream failures"],"whenToPreferThis":"Use this endpoint when you need to discover which FRED economic time series exist under a given thematic tag (e.g. 'gdp', 'inflation', 'nsa', 'monthly') before fetching actual data values. It is ideal for browsing and cataloging available series by topic rather than retrieving specific observations. Prefer this over direct FRED API access when you want a lightweight, pay-per-call interface with no API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:47:25.941Z","isFirstParty":false}