{"uid":"cap_iTnHva4MMZeBnzZDiDr-g","slug":"fathom-macroeconomic-data-api-tags-endpoint-538e6668","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://fredthom.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.35","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.35/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xC30Jf9AC-MTXDmaVU6dD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.35","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of available tags/categories used to organize FRED economic time series, with optional keyword filtering and result limiting","exampleAgentPrompt":"Search the Fathom macroeconomic data API for up to 20 tags related to 'inflation' so I can see what categories of FRED economic series are available on that topic.","exampleUseCases":null,"resultDescription":"An array of tag objects available in the FRED dataset, filtered by the search keyword if provided, plus a source identifier string. Each tag represents a category or label used to organize the 816,000+ economic time series in the database.","failureModes":["Invalid or missing limit parameter type (string expected, not integer)","No tags found matching the search keyword — returns empty tags array","API payment failure via x402 — 402 Payment Required if USDC not sent","Network timeout on Vercel serverless function","Search keyword too broad — returns full default 50 results without meaningful filtering"],"whenToPreferThis":"Use this endpoint when an agent needs to discover what categories or topics of economic data are available in the FRED database before querying specific series. It is the right entry point for navigating the taxonomy of 816,000+ economic time series — ideal for building dynamic search flows, populating dropdown filters, or understanding what macroeconomic domains are covered.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:19.897Z","isFirstParty":false}