{"uid":"cap_C2r21joUBr1KIaHtQvBSm","slug":"answerpool-xbrl-frame-4b1b1456","name":"AnswerPool XBRL Frame","description":"AnswerPool turns SEC EDGAR, the Federal Register, USAspending, NIH, BLS and OpenAlex into structured JSON answers that AI agents and developers fetch in one call. 69 endpoints free, no account; derived analyses $0.02–$0.05 per call by card credits or USDC (x402). MCP server, full provenance.","url":"https://answerpool.io/v1/sec/xbrl/frame","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","title":"FrameIn","required":["metric","period"],"properties":{"limit":{"type":"integer","title":"Limit","default":50,"maximum":200,"minimum":1,"description":"Number of filers to return, ranked by reported value descending; total_filers reports the full population. Default 50."},"metric":{"type":"string","title":"Metric","maxLength":120,"description":"Required metric key from /v1/sec/xbrl/metrics (e.g. revenue) or a raw US-GAAP XBRL concept as us-gaap:<Tag>; one tag is queried across all filers."},"period":{"type":"string","title":"Period","pattern":"^CY\\d{4}(Q[1-4])?I?$","maxLength":12,"description":"e.g. CY2025, CY2025Q1, CY2025Q1I"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"tag":"Revenues","top":[{"cik":"0000320193","value":94000000000,"entity":"Apple Inc."}],"as_of":"2026-08-31T14:00:00Z","metric":"revenue","period":"CY2025Q1","total_filers":4000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7Y40qJREMViDq78F8wdBQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Rank all SEC filers on a single XBRL financial metric for a given period, returning top-N entity values and the total filer count.","exampleAgentPrompt":"Pull the top 50 SEC filers ranked by Revenues for CY2024Q1 — I want entity names, their reported values, and the total number of filers that reported that metric.","exampleUseCases":[{"title":"Whole-market revenue ranking screen","prompt":"Show me the top 100 public companies ranked by Revenues for the full year CY2024 — include their names, CIK numbers, reported values, and how many companies total filed that metric."},{"title":"R&D spend competitive benchmark","prompt":"Rank all SEC filers by ResearchAndDevelopmentExpense for CY2023 and give me the top 50 — I want to see who's spending the most on R&D market-wide."},{"title":"Quarterly earnings per share leaderboard","prompt":"Get me the top 200 companies by EarningsPerShareBasic for CY2024Q1 with entity names and values, and tell me how many total filers reported that XBRL tag."}],"resultDescription":"Returns a JSON object containing the XBRL tag name, the requested metric slug, the period, an as-of timestamp, the total number of filers that reported the metric, and an array of top-N rows each with the company's CIK, entity name, and reported numeric value. Also includes a disclaimer noting the data is derived from public SEC EDGAR filings.","failureModes":["Invalid metric name returns an error or empty result if no XBRL tag matches","Invalid period format (must match CY####, CY####Q#, or CY####Q#I) returns a validation error","Period with no available XBRL frame data returns empty top array","Limit outside 1–200 range returns a validation error","Payment failure (x402) blocks the request if USDC funds are insufficient","SEC EDGAR frames API lag may mean very recent periods return no data yet"],"whenToPreferThis":"Use this endpoint when you need a whole-market financial ranking on a single XBRL metric without building or maintaining a bulk XBRL data pipeline. It is ideal for market screening, competitive benchmarking, and sector analysis where you want to see how all SEC filers stack up on one standardized financial concept for a specific calendar period. Prefer it over company-specific XBRL endpoints when the goal is cross-company comparison rather than deep-diving a single filer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:02:20.022Z","isFirstParty":false}