# Congress.gov Legislation - Bills, Votes & Sponsors (`pink_comic/congress-gov-legislation-tracker`) Actor

Track US legislation from Congress.gov. Public records on bills, resolutions, sponsors, and status. Government data for policy research, lobbying intelligence, regulatory monitoring, and compliance teams.

- **URL**: https://apify.com/pink\_comic/congress-gov-legislation-tracker.md
- **Developed by:** [Ava Torres](https://apify.com/pink_comic) (community)
- **Categories:** Developer tools, Business, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Congress.gov - Federal Legislation & Bill Tracker

Search and monitor US federal legislation from Congress.gov. Filter by congress number, bill type, policy area, and keyword. Get bill titles, sponsors, cosponsors, introduced dates, latest actions, and direct Congress.gov links. Results in seconds, not manual archive searches.

No browser automation. Reads directly from the official Congress.gov API.

---

### What You Get

Each result is one federal bill or resolution.

| Field | Type | Description |
|---|---|---|
| `billNumber` | string | Bill number (e.g. 1234) |
| `billType` | string | Bill type: HR, S, HJRES, SJRES, HRES, SRES |
| `congress` | integer | Congress number (e.g. 118 for the 118th Congress, 2023-2025) |
| `billTitle` | string | Full bill title |
| `introducedDate` | string | Date the bill was introduced |
| `latestActionDate` | string | Date of the most recent action |
| `latestActionText` | string | Description of the most recent action |
| `sponsors` | string | Sponsor names (comma-separated) |
| `cosponsorsCount` | integer | Number of cosponsors |
| `policyArea` | string | Assigned policy area (e.g. Energy, Health, Transportation) |
| `originChamber` | string | Originating chamber (House or Senate) |
| `updateDate` | string | Date the record was last updated |
| `url` | string | Direct Congress.gov URL for this bill |

---

### Sample Output

```json
{
  "billNumber": "5376",
  "billType": "HR",
  "congress": 117,
  "billTitle": "Inflation Reduction Act of 2022",
  "introducedDate": "2022-08-12",
  "latestActionDate": "2022-08-16",
  "latestActionText": "Became Public Law No: 117-169.",
  "sponsors": "John Yarmuth",
  "cosponsorsCount": 0,
  "policyArea": "Economics and Public Finance",
  "originChamber": "House",
  "url": "https://www.congress.gov/bill/117th-congress/house-bill/5376"
}
````

***

### Who Uses This

**Government affairs and lobbying teams** tracking legislation relevant to their clients. Search by policy area and keyword to monitor bills from introduction through final action without manually checking Congress.gov each day.

**Compliance and regulatory teams** monitoring legislation that could affect their industry. Filter by policy area (Health, Finance, Energy, Transportation) to catch bills early and build response timelines before they reach final passage.

**Law firms and policy research groups** building structured datasets of legislative activity. Batch-export bills by congress, chamber, and subject for comparative analysis, briefing materials, or academic research.

**Corporate government relations teams** tracking sponsor and cosponsor counts as signals of legislative momentum. High cosponsor counts on bills in your sector indicate political will that warrants early attention.

**Journalists and policy analysts** mapping legislative trends over time. Pull all bills from a given congress in a specific policy area to quantify activity, identify repeat sponsors, and measure how far bills advanced.

***

### How to Use

#### Step 1: Configure your input

**Search by keyword across the current congress:**

```json
{
  "searchTerm": "infrastructure",
  "congress": 118,
  "maxResults": 50
}
```

**Filter by bill type:**

```json
{
  "searchTerm": "climate",
  "congress": 118,
  "billType": "s",
  "maxResults": 25
}
```

**Filter by policy area after keyword search:**

```json
{
  "searchTerm": "healthcare",
  "congress": 118,
  "subject": "Health",
  "maxResults": 100
}
```

**Use your own API key for higher throughput:**

```json
{
  "searchTerm": "energy",
  "congress": 118,
  "apiKey": "YOUR_CONGRESS_GOV_KEY",
  "maxResults": 250
}
```

#### Input reference

| Parameter | Type | Description |
|---|---|---|
| `searchTerm` | string | Keyword to filter bills by title (e.g. climate, healthcare, infrastructure). |
| `congress` | integer | US Congress number (e.g. 118 for 2023-2025, 117 for 2021-2023). Default 118. |
| `billType` | string | Bill type filter: hr, s, hjres, sjres, hres, sres. Leave blank for all types. |
| `subject` | string | Policy area filter applied after fetching details (e.g. Energy, Health, Transportation). |
| `apiKey` | string | Congress.gov API key. Leave blank to use DEMO\_KEY (40 req/hr). Register free at api.congress.gov. |
| `maxResults` | integer | Maximum number of bills to return. Default 20, max 250. |

***

### Cost Estimate

Pricing is $0.002 per result.

| Run size | Estimated cost |
|---|---|
| 20 results | ~$0.04 |
| 100 results | ~$0.20 |
| 250 results | ~$0.50 |

***

### Output Formats

Results are available in JSON, CSV, and Excel from the Apify dataset viewer. Connect to downstream tools via the Apify API or webhooks.

***

### FAQ

**Does this require a paid API key?**
No. The actor uses the free DEMO\_KEY by default, which allows 40 requests per hour. For higher throughput, register a free personal key at api.congress.gov, which provides 5,000 requests per hour.

**What congress numbers are available?**
Congress.gov covers the 93rd Congress (1973) through the current congress. The 118th Congress covers 2023-2025. The 119th Congress began January 2025.

**What bill types are supported?**
HR (House Bill), S (Senate Bill), HJRES (House Joint Resolution), SJRES (Senate Joint Resolution), HRES (House Resolution), SRES (Senate Resolution). Pass the lowercase abbreviation (e.g. `hr`, `s`).

**How does the subject filter work?**
The `subject` field filters by the policy area assigned by the Congressional Research Service. It is applied after the keyword search. Common values include Health, Energy, Finance and Financial Sector, Transportation and Public Works, Environmental Protection, and Armed Forces and National Security.

**Is the data real-time?**
Yes. The actor queries the live Congress.gov API on each run. Results reflect the current state of the database including the latest bill actions and cosponsor counts at the time of the run.

# Actor input Schema

## `searchTerm` (type: `string`):

Keyword to filter bills by title (e.g. "climate", "healthcare", "infrastructure").

## `congress` (type: `integer`):

US Congress number to filter by (e.g. 118 for the 118th Congress, 2023-2025). Leave blank for all congresses.

## `billType` (type: `string`):

Type of legislation: hr (House Bill), s (Senate Bill), hjres (House Joint Resolution), sjres (Senate Joint Resolution), hres (House Resolution), sres (Senate Resolution). Leave blank for all types.

## `subject` (type: `string`):

Filter results by policy area (e.g. "Energy", "Health", "Transportation"). Applied after fetching bill details.

## `apiKey` (type: `string`):

Congress.gov API key. Leave blank to use DEMO\_KEY (rate-limited but functional). Get a free key at api.congress.gov.

## `maxResults` (type: `integer`):

Maximum number of bills to return.

## Actor input object example

```json
{
  "searchTerm": "infrastructure",
  "congress": 118,
  "billType": "hr",
  "subject": "",
  "apiKey": "",
  "maxResults": 20
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerm": "infrastructure",
    "congress": 118,
    "billType": "hr",
    "subject": "",
    "apiKey": "",
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("pink_comic/congress-gov-legislation-tracker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerm": "infrastructure",
    "congress": 118,
    "billType": "hr",
    "subject": "",
    "apiKey": "",
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("pink_comic/congress-gov-legislation-tracker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerm": "infrastructure",
  "congress": 118,
  "billType": "hr",
  "subject": "",
  "apiKey": "",
  "maxResults": 20
}' |
apify call pink_comic/congress-gov-legislation-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=pink_comic/congress-gov-legislation-tracker",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Congress.gov Legislation - Bills, Votes & Sponsors",
        "description": "Track US legislation from Congress.gov. Public records on bills, resolutions, sponsors, and status. Government data for policy research, lobbying intelligence, regulatory monitoring, and compliance teams.",
        "version": "0.1",
        "x-build-id": "Xs5jXBuJEtvJVlGzZ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/pink_comic~congress-gov-legislation-tracker/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-pink_comic-congress-gov-legislation-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/pink_comic~congress-gov-legislation-tracker/runs": {
            "post": {
                "operationId": "runs-sync-pink_comic-congress-gov-legislation-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/pink_comic~congress-gov-legislation-tracker/run-sync": {
            "post": {
                "operationId": "run-sync-pink_comic-congress-gov-legislation-tracker",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchTerm": {
                        "title": "Search Term",
                        "type": "string",
                        "description": "Keyword to filter bills by title (e.g. \"climate\", \"healthcare\", \"infrastructure\").",
                        "default": ""
                    },
                    "congress": {
                        "title": "Congress Number",
                        "minimum": 1,
                        "type": "integer",
                        "description": "US Congress number to filter by (e.g. 118 for the 118th Congress, 2023-2025). Leave blank for all congresses.",
                        "default": 118
                    },
                    "billType": {
                        "title": "Bill Type",
                        "type": "string",
                        "description": "Type of legislation: hr (House Bill), s (Senate Bill), hjres (House Joint Resolution), sjres (Senate Joint Resolution), hres (House Resolution), sres (Senate Resolution). Leave blank for all types.",
                        "default": ""
                    },
                    "subject": {
                        "title": "Policy Area / Subject",
                        "type": "string",
                        "description": "Filter results by policy area (e.g. \"Energy\", \"Health\", \"Transportation\"). Applied after fetching bill details.",
                        "default": ""
                    },
                    "apiKey": {
                        "title": "API Key",
                        "type": "string",
                        "description": "Congress.gov API key. Leave blank to use DEMO_KEY (rate-limited but functional). Get a free key at api.congress.gov.",
                        "default": ""
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 1,
                        "maximum": 250,
                        "type": "integer",
                        "description": "Maximum number of bills to return."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```