{"uid":"cap_UweVDBWRS9qzvYh0_Eywa","slug":"us-regulation-counts-82471897","name":"US Regulation Counts","description":"US federal regulation counts — how many Federal Register documents match a search, grouped by agency, document type, year, quarter, month, topic or section, with the same filters as the search. Use to see which agencies regulate a subject, how rulemaking activity moved over time, or which topics a term touches.","url":"https://us-regulations.use.x402atlas.com/counts?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"rin":{"type":"string","maxLength":64},"type":{"type":"string","maxLength":60,"description":"Comma-separated of rule, proposed_rule, notice, presidential"},"facet":{"enum":["agency","type","yearly","quarterly","monthly","topic","section"],"type":"string","default":"agency"},"query":{"type":"string","maxLength":200,"description":"Full-text search"},"since":{"type":"string","format":"date","description":"Published on or after, YYYY-MM-DD"},"until":{"type":"string","format":"date","description":"Published on or before, YYYY-MM-DD"},"agency":{"type":"string","maxLength":500,"description":"Comma-separated agency slugs, up to 5"},"docket":{"type":"string","maxLength":64},"cfr_part":{"type":"string","maxLength":9,"description":"Requires cfr_title"},"cfr_title":{"type":"integer","maximum":50,"minimum":1},"significant":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["as_of","source","caveat","modified","query","agency","type","since","until","facet","total","count","buckets"],"properties":{"note":{"type":"string","description":"Present only on a sample or empty response"},"type":{"type":"array","items":{"type":"string"}},"as_of":{"type":"string","format":"date-time","description":"Retrieval time, UTC"},"count":{"type":"integer","description":"Groups returned, at most 50"},"facet":{"enum":["agency","type","yearly","quarterly","monthly","topic","section"],"type":"string"},"query":{"type":"string"},"since":{"type":"string","description":"Applied; empty when none"},"total":{"type":"integer","description":"Sum over all groups"},"until":{"type":"string","description":"Applied; empty when none"},"agency":{"type":"array","items":{"type":"string"}},"caveat":{"type":"string","description":"Fixed interpretation note"},"source":{"type":"object","required":["name","url","citation"],"properties":{"url":{"type":"string"},"name":{"type":"string"},"citation":{"type":"string"}},"additionalProperties":false},"buckets":{"type":"array","items":{"type":"object","required":["key","label","count"],"properties":{"key":{"type":"string","description":"Agency slug, type, period start date, topic or section slug"},"count":{"type":"integer"},"label":{"type":"string"}},"additionalProperties":false}},"modified":{"type":"boolean","description":"Always true: fields are normalized, not the official record"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_x7-qHnT9LQji7upgk1wtK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns faceted counts of Federal Register documents matching a search query, grouped by agency, document type, year, quarter, month, topic, or section.","exampleAgentPrompt":"How many Federal Register documents mention 'artificial intelligence', broken down by agency? Search from 2020-01-01 to today and group by agency.","exampleUseCases":[{"title":"Agency rulemaking volume on a topic","prompt":"How many federal rules and proposed rules mention 'cryptocurrency' have been published since 2018, grouped by agency? I want to see which regulators are most active on this topic."},{"title":"Yearly rulemaking trend for a subject","prompt":"Show me how rulemaking activity on 'climate change' in the Federal Register has moved over time — break it down by year from 2010 to today."},{"title":"Document type breakdown for an agency","prompt":"For the EPA, how many rules, proposed rules, and notices were published in the last two years? Group the counts by document type so I can see their regulatory output mix."}],"resultDescription":"Returns a list of up to 50 buckets for the chosen facet dimension (e.g. agency slugs, years, document types, topics), each with a label and a document count, plus the total number of matching documents and metadata such as retrieval timestamp, applied filters, and any caveat notes.","failureModes":["Missing required 'query' parameter returns a validation error","Invalid facet enum value returns a 400 error","Agency slug not found in registry returns zero-count buckets","Date format not conforming to YYYY-MM-DD causes a parsing error","cfr_part supplied without cfr_title returns a validation error","More than 5 agency slugs in the agency parameter may be rejected","Query returns no matches, resulting in empty buckets list with total=0"],"whenToPreferThis":"Use this endpoint when you need aggregate statistics or trend analysis over Federal Register documents rather than the documents themselves. Prefer it over the search endpoint when the goal is to count, compare, or visualize regulatory activity — for instance, determining which agencies regulate a topic, how rulemaking volume changed over time, or which document types dominate for a keyword. It is the right choice for dashboards, policy research, and compliance landscape assessments where counts matter more than individual document content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:38:37.938Z","isFirstParty":false,"canonicalSlug":"us-regulation-counts-82471897"}