{"uid":"cap_TwRpvuMSkna3ILrfeLzxc","slug":"fathom-macroeconomic-data-api-tags-search-d8717abf","name":"Fathom Macroeconomic Data API — Tags Search","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fredfathom.vercel.app/api/tags","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"string","description":"Max results (default: 50)"},"search":{"type":"string","description":"Filter tags by keyword"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"tags":{"type":"array","items":{"type":"object"}},"source":{"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_HPiiO0FgT2kFM_6TILQ3a","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":"Search and retrieve available tags from 816,000+ FRED economic time series to discover categorized macroeconomic data topics","exampleAgentPrompt":"Search the Fathom FRED data API for tags related to 'inflation' and show me up to 20 results so I can figure out which economic series to pull.","exampleUseCases":[{"title":"Discover inflation data categories","prompt":"Can you search the FRED macroeconomic data tags for anything related to 'inflation' and list up to 30 results? I want to see what categories are available before pulling the actual series."},{"title":"Browse unemployment data tags","prompt":"Show me all the FRED data tags that match 'unemployment' — just return up to 50 so I can pick the right one for my analysis."},{"title":"Explore interest rate series tags","prompt":"Search the Fathom FRED API tags for 'interest rate' and give me the first 25 results so I can figure out which tag to use when fetching actual rate data."}],"resultDescription":"An array of tag objects from the FRED database matching the search keyword, along with a source attribution string. Each tag represents a category or label applied to one or more economic time series, enabling the caller to identify which tags to use for subsequent data queries.","failureModes":["No tags found for obscure or misspelled search keywords — returns empty array","Rate limiting or payment failure if x402 payment is not properly handled — returns payment required error","Invalid limit parameter format — may return default 50 results or error","Service unavailable if FRED upstream is down — returns 5xx error"],"whenToPreferThis":"Choose this endpoint when you need to discover or browse available FRED data categories before fetching actual economic time series data. It is ideal as a first step in a two-stage workflow: search tags here, then use the relevant tag to fetch specific series. Prefer this over direct series lookup when the exact tag name is unknown or when you want to explore what macroeconomic topics are covered.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:57.856Z","isFirstParty":false}