{"uid":"cap_my5t3FpzmR4C9W9wWpqcp","slug":"legislative-search-7a57f584","name":"legislative-search","description":"Search US federal bills by keyword (optionally within one Congress) and get a ranked list of matching bills with id, title and latest action. Source: Congress.gov, public-domain.","url":"https://payai.agentstools.dev/legislative/search","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","required":[],"properties":{"q":{"type":"string","description":"Keyword / phrase to search bill text"},"limit":{"type":"integer","maximum":25,"minimum":1,"description":"Max bills to return, default 10"},"keyword":{"type":"string","description":"Alias for q"},"sponsor":{"type":"string","description":"Optional sponsor name filter"},"congress":{"type":"integer","description":"Optional Congress number to scope the search"},"policyArea":{"type":"string","description":"Optional policy-area keyword to filter results"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_SJ5-gCxJ0m9dFHrU8nT__","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":"Search US federal bills by keyword, optionally filtered by Congress number, sponsor, or policy area, returning a ranked list of matching bills with IDs, titles, and latest actions","exampleAgentPrompt":"Search for US federal bills about 'artificial intelligence regulation' in the 118th Congress and return the top 10 results with their IDs, titles, and latest actions.","exampleUseCases":[{"title":"Tracking climate legislation progress","prompt":"Find me federal bills related to 'climate change' introduced in the 118th Congress — show up to 15 results with their titles and the latest action taken on each."},{"title":"Policy researcher bill discovery","prompt":"Search US federal legislation for bills about 'prescription drug pricing' sponsored by any senator, and give me the top 10 matches with bill IDs and where they stand."},{"title":"Lobbying and advocacy monitoring","prompt":"Look up federal bills in Congress.gov related to the policy area 'gun control' — I need the bill IDs, titles, and latest congressional actions for the most relevant 10 results."}],"resultDescription":"A ranked list of matching US federal bills, each including the bill ID, full title, and a description of the latest action taken (e.g. referred to committee, passed House, signed into law). Results are sourced from Congress.gov public-domain data.","failureModes":["No bills found matching the keyword — returns empty list","Congress number out of valid range — may return error or empty results","Limit parameter exceeds maximum of 25 — rejected with validation error","Vague or overly broad keyword returns too many low-relevance results","Congress.gov upstream unavailable — service may return timeout or error"],"whenToPreferThis":"Use this endpoint when you need to search US federal legislative records by keyword, topic, sponsor, or policy area and retrieve structured bill metadata including latest congressional actions. Prefer this over general web search when you need structured, authoritative, public-domain bill data directly from Congress.gov with consistent field schemas (bill ID, title, latest action). Best for policy research, legislative monitoring, lobbying intelligence, and compliance checks against federal law activity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:13.174Z","isFirstParty":false}