{"uid":"cap__kuIjxyYvYBRynq3o7-CQ","slug":"fathom-macroeconomic-data-api-tags-endpoint-f502d88f","name":"Fathom Macroeconomic Data API — Tags Endpoint","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/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_dU6jJYS2inmZyzj-hTlKF","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":"Returns a list of available tags (category/topic labels) for browsing and filtering the 816,000+ FRED-powered economic time series","exampleAgentPrompt":"Can you show me all the available economic data tags in Fathom's FRED-powered database — maybe filter by keyword 'inflation' and return up to 20 results?","exampleUseCases":[{"title":"Discover inflation-related data categories","prompt":"I want to explore what inflation-related economic data is available — can you search Fathom's macroeconomic database for tags matching 'inflation' and list up to 30?"},{"title":"Browse all macroeconomic topic labels","prompt":"Show me all the topic tags available in the Fathom macroeconomic database — give me up to 50 categories so I can figure out what economic time series I can pull."},{"title":"Find tags for unemployment research","prompt":"I'm doing research on labor markets — can you query Fathom's FRED database for tags related to 'unemployment' and return up to 25 results?"}],"resultDescription":"Returns an array of tag objects (each representing a category or topic label used to classify FRED economic time series) and a source identifier string indicating the data origin. Tags can be used to discover and filter specific economic time series data.","failureModes":["Empty tag list if search keyword matches nothing in the database","Missing or malformed limit parameter may default to 50 results","Service unavailability on the Vercel-hosted endpoint returning 5xx errors","Payment failure if x402 USDC payment of $0.04 is not properly submitted","Stale or cached results if the underlying FRED data source is not refreshed"],"whenToPreferThis":"Choose this endpoint when you need to discover or browse the taxonomy of available economic data categories before querying specific time series. It is the right first step when you don't know the exact tag name and want to explore what macroeconomic topics (GDP, inflation, unemployment, interest rates) are indexed. Prefer this over directly querying series if you need to enumerate valid filter terms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:25.228Z","isFirstParty":false}