{"uid":"cap_0b7IAUBVJpUSZN3VmhFLs","slug":"fathom-macroeconomic-data-api-search-tags-4ed4f76d","name":"Fathom Macroeconomic Data API — Search Tags","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/search-tags","method":"POST","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"limit":{"type":"string","description":"Max results (default: 20)"},"query":{"type":"string","description":"Search keyword"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"tags":{"type":"array","items":{"type":"object"}},"query":{"type":"string"},"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_7YVnxKCcirinSJVcc52U1","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 for FRED economic data series tags by keyword to discover available macroeconomic indicators","exampleAgentPrompt":"Search the Fathom macroeconomic API for tags related to 'inflation' so I can find the right FRED economic series to pull CPI data from — limit the results to 10.","exampleUseCases":[{"title":"Discovering GDP indicator tags","prompt":"Search the Fathom FRED API for tags related to 'GDP' and return up to 20 results so I can see what economic series are available for gross domestic product analysis."},{"title":"Finding unemployment data series tags","prompt":"I need to find FRED data tags for 'unemployment' — can you search the Fathom macroeconomic API and show me up to 15 matching tags?"},{"title":"Exploring interest rate data categories","prompt":"Search Fathom's FRED-powered API for tags matching 'interest rates' so I can discover which economic series and categories are available for monetary policy research — give me the top 10 results."}],"resultDescription":"Returns an array of FRED tag objects matching the search keyword, along with the original query string and the data source identifier. Each tag object describes a category or label used to classify economic time series in the FRED database.","failureModes":["Missing required 'query' field returns validation error","Empty query string may return no results or an error","Network timeout on Vercel serverless cold start","FRED upstream unavailability causing 502/503 responses","Limit parameter ignored or misformatted if not passed as a string"],"whenToPreferThis":"Use this endpoint when you need to discover what economic data tags exist in the FRED database before fetching actual time series data. It is the right first step for navigating 816,000+ FRED series by keyword, especially when the exact series ID is unknown. Prefer this over a direct series search when the goal is category/tag discovery rather than retrieving numeric data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:43:09.468Z","isFirstParty":false}