{"uid":"cap_2A9LGoQo2R1p0acVqt9x9","slug":"fathom-macroeconomic-data-api-tags-endpoint-00732286","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://fathoms.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_nbInwOMnCVOx3IVNVV7lC","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":"Retrieves and searches available tags/categories for 816,000+ FRED-powered macroeconomic economic time series","exampleAgentPrompt":"Search the Fathom macroeconomic database for tags related to 'inflation' and show me up to 20 results so I can find the right category for economic time series data.","exampleUseCases":[{"title":"Discover inflation-related data categories","prompt":"What tags does the Fathom macroeconomic database have related to inflation? Show me up to 30 results so I can find the right series to track."},{"title":"Browse all available economic indicator tags","prompt":"Can you pull the full list of macroeconomic tags from Fathom — give me up to 50 — so I can see what economic categories are available before I start pulling time series data?"},{"title":"Find unemployment data classifications","prompt":"Search Fathom's economic data tags for anything related to 'unemployment' and return the top 25 matches so I know which categories to use for my labor market analysis."}],"resultDescription":"Returns a JSON object containing an array of tag objects (each describing an available macroeconomic category or classification from the FRED-backed database) and a source string indicating the data provider. Tags can be used to filter or discover specific economic time series.","failureModes":["Invalid or missing body parameters may return an error or default response","No tags found matching the search keyword returns an empty tags array","Server-side FRED data source unavailability may cause delayed or failed responses","Overly broad or misspelled search terms may return irrelevant or no tags","Rate limiting or payment failure may block access to the endpoint"],"whenToPreferThis":"Use this endpoint when you need to discover or browse available categories/tags within the Fathom macroeconomic database before querying specific time series. It is ideal as a first step in a workflow where you want to find the right classification for GDP, inflation, unemployment, interest rates, or other economic indicators. Prefer this over direct series queries when you don't yet know the exact tag or category name for the data you need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:30.447Z","isFirstParty":false}