Twinkle HubTwinkle Hub

美國國會法案搜尋 (Congress.gov)

us_search_bills

🇺🇸 États-Unislecture seule

關鍵字 / Keywords: 美國國會 法案 眾議院 參議院 提案 表決 議員 congress bill house senate legislation vote sponsor amendment 118th 119th HR resolution

Scope: US Congress bills via Congress.gov (Library of Congress).

Paginated catalog of bills for one Congress (+ optional type / date window). Not a full-text search — Congress.gov's /v3/bill family is a directory; for keyword search within a bill's text use the GovInfo BILLS collection via a separate call.

Endpoint: GET https://api.congress.gov/v3/bill/{congress}[/{bill_type}]

Args: congress: Congress number (e.g. 118 for 2023-2024, 119 for 2025-2026). None → hits /v3/bill for the latest. bill_type: hr (House bill) · s (Senate bill) · hjres / sjres (joint resolutions) · hconres / sconres (concurrent) · hres / sres (simple resolutions). None → all types. from_date / to_date: YYYY-MM-DD update-date filter. limit: max rows (default 20, Congress.gov cap 250). offset: pagination offset.

Returns dict with bills — each row has congress, bill_type, number, title, origin_chamber, introduced_date, latest_action_date, latest_action_text, original_url (link to www.congress.gov reader page). Plus total_available from Congress.gov pagination metadata. License: US Public Domain (17 USC §105). Requires US_CONGRESS_API_KEY env for signed rate ceiling (5000/hr); DEMO_KEY fallback ~10 req/hr.

Paramètres

NomTypeDescription
congressinteger
bill_typestring
from_datestring
to_datestring
limitinteger
offsetinteger
Schéma JSON brut
{
  "properties": {
    "congress": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Congress"
    },
    "bill_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Bill Type"
    },
    "from_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "From Date"
    },
    "to_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "To Date"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "title": "Offset",
      "type": "integer"
    }
  },
  "title": "us_search_billsArguments",
  "type": "object"
}

Comment appeler

Amorce — paramètres dans le tableau
us_search_bills({ congress: 10 })