# Lobbying Disclosure (LDA) Database Scraper (`crawlerbros/lobbying-disclosure-lda-scraper`) Actor

Scrape the U.S. Senate/House Lobbying Disclosure Act public database. Search quarterly lobbying filings, registrants, clients, lobbyists, and LD-203 political contribution disclosures. No API key required.

- **URL**: https://apify.com/crawlerbros/lobbying-disclosure-lda-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, Lead generation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Lobbying Disclosure (LDA) Database Scraper

Scrape the **U.S. Senate/House Lobbying Disclosure Act (LDA)** public database — the official federal registry of who lobbies Congress, for whom, on what issues, and for how much. Search quarterly lobbying filings, registrants (lobbying firms), clients (who hired lobbyists), individual lobbyists, and LD-203 political contribution disclosures. HTTP-only via the public `lda.senate.gov` REST API. No login, no API key.

### What this actor does

- **Six modes:** `filings`, `byFilingId`, `registrants`, `clients`, `lobbyists`, `contributions`
- **Full filing detail:** registrant & client info, every lobbyist named on the filing, every issue area lobbied, reported income/expenses, affiliated organizations, foreign entities
- **LD-203 contributions:** political contributions and gifts disclosed by lobbyists and lobbying firms twice a year
- **Finite dropdowns:** filing type (50 values), filing period, issue area (79 codes), US state, contribution type
- **Empty fields are omitted**

### Output per filing (mode = `filings`, `byFilingId`)

- `filingId`, `filingType`, `filingTypeDisplay`, `filingYear`, `filingPeriod`, `filingPeriodDisplay`
- `registrantId`, `registrantName`, `registrantDescription`, `registrantAddress`, `registrantCountry`, `registrantContactName`
- `clientId`, `clientName`, `clientDescription`, `clientState`, `clientCountry`, `clientIsGovernmentEntity`
- `issueAreas[]` — `{code, name, activityDescription}` per lobbied issue
- `issueAreaCodes[]` — unique issue-area codes for quick filtering
- `lobbyists[]` — `{name, coveredPosition, isNew}` per lobbyist named on the filing
- `affiliatedOrganizations[]`, `foreignEntities[]`
- `convictionDisclosures[]` — present only on the rare filing disclosing a lobbyist conviction (LDA requires this disclosure but it is almost never triggered)
- `incomeReported`, `expensesReported`, `amountReported`, `expensesMethod`
- `postedByName`, `filedDate`, `terminationDate`
- `filingDocumentUrl`, `sourceUrl`
- `recordType: "filing"`, `scrapedAt`

### Output per registrant (mode = `registrants`)

- `registrantId`, `houseRegistrantId`, `name`, `description`, `address`, `city`, `state`, `zip`, `country`, `principalPlaceOfBusinessCountry`
- `contactName`, `contactTelephone`, `lastUpdated`, `sourceUrl`
- `recordType: "registrant"`, `scrapedAt`

### Output per client (mode = `clients`)

- `clientId`, `name`, `description`, `state`, `country`, `principalPlaceOfBusinessState`, `principalPlaceOfBusinessCountry`
- `isGovernmentEntity`, `isSelfSelectCategory`, `effectiveDate`
- `registrantId`, `registrantName` — the firm currently representing this client
- `sourceUrl`, `recordType: "client"`, `scrapedAt`

### Output per lobbyist (mode = `lobbyists`)

- `lobbyistId`, `prefix`, `firstName`, `middleName`, `lastName`, `suffix`, `nickname`, `fullName`
- `registrantId`, `registrantName`, `sourceUrl`
- `recordType: "lobbyist"`, `scrapedAt`

### Output per contribution (mode = `contributions`)

One record per disclosed contribution line item (a single LD-203 filing can disclose several).

- `filingId`, `filingType`, `filingTypeDisplay`, `filingYear`, `filingPeriod`, `filingPeriodDisplay`
- `filerType`, `filerTypeDisplay` — `lobbyist` or `organization`
- `registrantId`, `registrantName`, `lobbyistId`, `lobbyistName`, `pacs[]`
- `contributionType`, `contributionTypeDisplay`, `contributorName`, `payeeName`, `honoreeName`, `amount`, `contributionDate`
- `filedDate`, `sourceUrl`
- `recordType: "contribution"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `filings` | `filings` / `byFilingId` / `registrants` / `clients` / `lobbyists` / `contributions` |
| `registrantName` | string | – | Lobbying firm name (most modes) |
| `clientName` | string | – | Client name (mode=filings, clients) |
| `lobbyistName` | string | – | Individual lobbyist name (mode=filings, lobbyists, contributions) |
| `filingIds` | array | – | Filing UUIDs (mode=byFilingId) |
| `filingType` | string | – | One of 50 filing type codes (mode=filings, contributions) |
| `filingYear` | int | – | Reporting year, 1999–2027 |
| `filingPeriod` | string | – | Quarter / mid-year / year-end |
| `issueAreaCode` | string | – | One of 79 general issue-area codes (mode=filings) |
| `filedDateFrom` / `filedDateTo` | string | – | `YYYY-MM-DD` filed-date range |
| `amountMin` / `amountMax` | int | – | Reported amount range (USD) |
| `state` | string | – | US state/territory (mode=registrants, clients) |
| `contributionType` | string | – | FECA / Honorary / Meeting / Presidential Library / Inaugural (mode=contributions) |
| `contributorName` / `payeeName` / `honoreeName` | string | – | LD-203 contribution item filters (mode=contributions) |
| `maxItems` | int | `20` | Hard cap on emitted records (1–2000) |
| `proxyConfiguration` | object | Apify proxy | Optional automatic fallback if the LDA API rate-limits/blocks the datacenter IP |

#### Example: recent filings by a registrant

```json
{
  "mode": "filings",
  "registrantName": "Akin Gump",
  "filingYear": 2025,
  "maxItems": 25
}
````

#### Example: who lobbies for a specific client

```json
{
  "mode": "filings",
  "clientName": "Google",
  "maxItems": 25
}
```

#### Example: filings on a specific issue area

```json
{
  "mode": "filings",
  "issueAreaCode": "TAX",
  "filingYear": 2025,
  "maxItems": 50
}
```

#### Example: lookup filings by ID

```json
{
  "mode": "byFilingId",
  "filingIds": ["7866327b-c892-4430-b9f0-1f0f679c58c6"]
}
```

#### Example: LD-203 political contributions above $500

```json
{
  "mode": "contributions",
  "amountMin": 500,
  "filingYear": 2023,
  "maxItems": 50
}
```

### Use cases

- **Journalism & watchdog research** — track which firms lobby for which clients and on what issues
- **Public affairs & GR teams** — monitor competitor lobbying registrations in real time
- **Political finance research** — cross-reference LD-203 contributions with campaign finance data
- **Compliance** — verify a firm's or client's LDA registration history
- **Academic research** — bulk-export lobbying activity by issue area or year

### FAQ

**What's the data source?** The official public REST API operated by the Office of the Secretary of the Senate / Clerk of the House at `lda.senate.gov`, covering all LDA filings since Congress began requiring electronic filing (1999) and LD-203 contribution reports since 2008.

**Is this official/affiliated with the U.S. Senate?** No — this is a third-party actor built on the publicly documented, unauthenticated REST API.

**Are there rate limits?** Yes, the upstream API allows ~15 anonymous requests/minute. The actor throttles itself and retries automatically to stay compliant — large `maxItems` values may take longer to complete.

**Why is `issueAreaCode` filtered locally instead of by the API?** The API doesn't expose general-issue-area as a server-side filter on the filings list endpoint, so the actor fetches candidate filings and filters them itself.

**Can I fetch every filing with zero filters and a very large `maxItems`?** Yes. The upstream API only allows paging past the first 25 results when at least one filter param is present on the request, so with zero filters supplied the actor automatically adds a harmless no-op date filter (`filedDateFrom=1999-01-01`, which matches everything since LDA data starts in 1999) behind the scenes to unlock full pagination — you'll get up to `maxItems` records either way.

**What's the difference between a "registrant" and a "client"?** A registrant is the lobbying firm or in-house lobbyist doing the lobbying; a client is the organization that hired them (which can be the same entity for in-house lobbyists).

**What are LD-203 contributions?** Twice a year, registered lobbyists and lobbying firms must disclose political contributions, PAC affiliations, and certain gifts/expenses (honorary, meeting, presidential library/inaugural) — separate from the quarterly LD-2 activity filings.

**How fresh is the data?** Filings are posted to the API as soon as they're processed by the Senate/House, typically within days of submission.

# Actor input Schema

## `mode` (type: `string`):

What to fetch.

## `registrantName` (type: `string`):

Filter by the lobbying firm name (mode=filings, registrants, clients, lobbyists, contributions). Partial match.

## `clientName` (type: `string`):

Filter by the client (the organization that hired the lobbyist) name (mode=filings, clients). Partial match.

## `lobbyistName` (type: `string`):

Filter by individual lobbyist name (mode=filings, lobbyists, contributions). Partial match.

## `filingIds` (type: `array`):

Filing UUIDs to look up directly, e.g. `7866327b-c892-4430-b9f0-1f0f679c58c6`.

## `filingType` (type: `string`):

Restrict to one filing type (mode=filings, contributions): registration, quarterly report, termination, or amendment.

## `filingYear` (type: `integer`):

Restrict to filings/contributions for a specific reporting year (mode=filings, contributions). LDA data starts in 1999.

## `filingPeriod` (type: `string`):

Restrict to a specific reporting period (mode=filings, contributions).

## `issueAreaCode` (type: `string`):

Restrict filings to those that lobbied on a specific general issue area (mode=filings). Applied client-side against each filing's lobbying activities.

## `filedDateFrom` (type: `string`):

Only include filings/contributions posted on or after this date (mode=filings, contributions).

## `filedDateTo` (type: `string`):

Only include filings/contributions posted on or before this date (mode=filings, contributions).

## `amountMin` (type: `integer`):

Only include filings with reported income/expenses at or above this amount (mode=filings). Also applies to LD-203 contribution amounts (mode=contributions).

## `amountMax` (type: `integer`):

Only include filings with reported income/expenses at or below this amount (mode=filings). Also applies to LD-203 contribution amounts (mode=contributions).

## `state` (type: `string`):

Restrict to a US state/territory (mode=registrants: registrant's state; mode=filings, clients: client's state).

## `contributionType` (type: `string`):

Restrict LD-203 contributions to a specific type (mode=contributions).

## `contributorName` (type: `string`):

Filter LD-203 contribution items by contributor name (mode=contributions).

## `payeeName` (type: `string`):

Filter LD-203 contribution items by payee name (mode=contributions).

## `honoreeName` (type: `string`):

Filter LD-203 contribution items by the honoree (e.g. the campaign/politician honored) (mode=contributions).

## `maxItems` (type: `integer`):

Hard cap on emitted records.

## `proxyConfiguration` (type: `object`):

Optional. The LDA API is fully open; proxy is only used as an automatic fallback if the API ever rate-limits or blocks the datacenter IP.

## Actor input object example

```json
{
  "mode": "filings",
  "filingIds": [],
  "filingType": "",
  "filingPeriod": "",
  "issueAreaCode": "",
  "state": "",
  "contributionType": "",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `records` (type: `string`):

Dataset containing all scraped LDA records.

# 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 = {
    "mode": "filings",
    "filingIds": [],
    "filingType": "",
    "filingPeriod": "",
    "issueAreaCode": "",
    "state": "",
    "contributionType": "",
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/lobbying-disclosure-lda-scraper").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 = {
    "mode": "filings",
    "filingIds": [],
    "filingType": "",
    "filingPeriod": "",
    "issueAreaCode": "",
    "state": "",
    "contributionType": "",
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/lobbying-disclosure-lda-scraper").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 '{
  "mode": "filings",
  "filingIds": [],
  "filingType": "",
  "filingPeriod": "",
  "issueAreaCode": "",
  "state": "",
  "contributionType": "",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call crawlerbros/lobbying-disclosure-lda-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/lobbying-disclosure-lda-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Lobbying Disclosure (LDA) Database Scraper",
        "description": "Scrape the U.S. Senate/House Lobbying Disclosure Act public database. Search quarterly lobbying filings, registrants, clients, lobbyists, and LD-203 political contribution disclosures. No API key required.",
        "version": "1.0",
        "x-build-id": "0aZCd9h2kpADMXGr1"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~lobbying-disclosure-lda-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-lobbying-disclosure-lda-scraper",
                "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/crawlerbros~lobbying-disclosure-lda-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-lobbying-disclosure-lda-scraper",
                "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/crawlerbros~lobbying-disclosure-lda-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-lobbying-disclosure-lda-scraper",
                "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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "filings",
                            "byFilingId",
                            "registrants",
                            "clients",
                            "lobbyists",
                            "contributions"
                        ],
                        "type": "string",
                        "description": "What to fetch.",
                        "default": "filings"
                    },
                    "registrantName": {
                        "title": "Registrant / firm name",
                        "type": "string",
                        "description": "Filter by the lobbying firm name (mode=filings, registrants, clients, lobbyists, contributions). Partial match."
                    },
                    "clientName": {
                        "title": "Client name",
                        "type": "string",
                        "description": "Filter by the client (the organization that hired the lobbyist) name (mode=filings, clients). Partial match."
                    },
                    "lobbyistName": {
                        "title": "Lobbyist name",
                        "type": "string",
                        "description": "Filter by individual lobbyist name (mode=filings, lobbyists, contributions). Partial match."
                    },
                    "filingIds": {
                        "title": "Filing IDs (mode=byFilingId)",
                        "type": "array",
                        "description": "Filing UUIDs to look up directly, e.g. `7866327b-c892-4430-b9f0-1f0f679c58c6`.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "filingType": {
                        "title": "Filing type",
                        "enum": [
                            "",
                            "RR",
                            "RA",
                            "Q1",
                            "Q1Y",
                            "1T",
                            "1TY",
                            "1A",
                            "1AY",
                            "1@",
                            "1@Y",
                            "Q2",
                            "Q2Y",
                            "2T",
                            "2TY",
                            "2A",
                            "2AY",
                            "2@",
                            "2@Y",
                            "Q3",
                            "Q3Y",
                            "3T",
                            "3TY",
                            "3A",
                            "3AY",
                            "3@",
                            "3@Y",
                            "Q4",
                            "Q4Y",
                            "4T",
                            "4TY",
                            "4A",
                            "4AY",
                            "4@",
                            "4@Y",
                            "MM",
                            "MMY",
                            "MT",
                            "MTY",
                            "MA",
                            "MAY",
                            "M@",
                            "M@Y",
                            "YY",
                            "YYY",
                            "YT",
                            "YTY",
                            "YA",
                            "YAY",
                            "Y@",
                            "Y@Y"
                        ],
                        "type": "string",
                        "description": "Restrict to one filing type (mode=filings, contributions): registration, quarterly report, termination, or amendment.",
                        "default": ""
                    },
                    "filingYear": {
                        "title": "Filing year",
                        "minimum": 1999,
                        "maximum": 2027,
                        "type": "integer",
                        "description": "Restrict to filings/contributions for a specific reporting year (mode=filings, contributions). LDA data starts in 1999."
                    },
                    "filingPeriod": {
                        "title": "Filing period",
                        "enum": [
                            "",
                            "first_quarter",
                            "second_quarter",
                            "third_quarter",
                            "fourth_quarter",
                            "mid_year",
                            "year_end"
                        ],
                        "type": "string",
                        "description": "Restrict to a specific reporting period (mode=filings, contributions).",
                        "default": ""
                    },
                    "issueAreaCode": {
                        "title": "Issue area",
                        "enum": [
                            "",
                            "ACC",
                            "ADV",
                            "AER",
                            "AGR",
                            "ALC",
                            "ANI",
                            "APP",
                            "ART",
                            "AUT",
                            "AVI",
                            "BAN",
                            "BNK",
                            "BEV",
                            "BUD",
                            "CIV",
                            "CHM",
                            "CAW",
                            "CDT",
                            "COM",
                            "CPI",
                            "CON",
                            "CSP",
                            "CPT",
                            "DEF",
                            "DIS",
                            "DOC",
                            "ECN",
                            "EDU",
                            "ENG",
                            "ENV",
                            "FAM",
                            "FIN",
                            "FIR",
                            "FOO",
                            "FOR",
                            "FUE",
                            "GAM",
                            "GOV",
                            "HCR",
                            "HOM",
                            "HOU",
                            "IMM",
                            "IND",
                            "INS",
                            "INT",
                            "LBR",
                            "LAW",
                            "MAN",
                            "MAR",
                            "MIA",
                            "MED",
                            "MMM",
                            "MON",
                            "NAT",
                            "PHA",
                            "POS",
                            "RRR",
                            "RES",
                            "REL",
                            "RET",
                            "ROD",
                            "SCI",
                            "SMB",
                            "SPO",
                            "TAR",
                            "TAX",
                            "TEC",
                            "TOB",
                            "TOR",
                            "TRD",
                            "TRA",
                            "TOU",
                            "TRU",
                            "URB",
                            "UNM",
                            "UTI",
                            "VET",
                            "WAS",
                            "WEL"
                        ],
                        "type": "string",
                        "description": "Restrict filings to those that lobbied on a specific general issue area (mode=filings). Applied client-side against each filing's lobbying activities.",
                        "default": ""
                    },
                    "filedDateFrom": {
                        "title": "Filed date from (YYYY-MM-DD)",
                        "type": "string",
                        "description": "Only include filings/contributions posted on or after this date (mode=filings, contributions)."
                    },
                    "filedDateTo": {
                        "title": "Filed date to (YYYY-MM-DD)",
                        "type": "string",
                        "description": "Only include filings/contributions posted on or before this date (mode=filings, contributions)."
                    },
                    "amountMin": {
                        "title": "Min amount reported (USD)",
                        "minimum": 0,
                        "maximum": 100000000,
                        "type": "integer",
                        "description": "Only include filings with reported income/expenses at or above this amount (mode=filings). Also applies to LD-203 contribution amounts (mode=contributions)."
                    },
                    "amountMax": {
                        "title": "Max amount reported (USD)",
                        "minimum": 0,
                        "maximum": 100000000,
                        "type": "integer",
                        "description": "Only include filings with reported income/expenses at or below this amount (mode=filings). Also applies to LD-203 contribution amounts (mode=contributions)."
                    },
                    "state": {
                        "title": "State",
                        "enum": [
                            "",
                            "AL",
                            "AK",
                            "AS",
                            "AZ",
                            "AR",
                            "AA",
                            "AE",
                            "AP",
                            "CA",
                            "CO",
                            "CT",
                            "DE",
                            "DC",
                            "FL",
                            "GA",
                            "GU",
                            "HI",
                            "ID",
                            "IL",
                            "IN",
                            "IA",
                            "KS",
                            "KY",
                            "LA",
                            "ME",
                            "MD",
                            "MA",
                            "MI",
                            "MN",
                            "MS",
                            "MO",
                            "MT",
                            "NE",
                            "NV",
                            "NH",
                            "NJ",
                            "NM",
                            "NY",
                            "NC",
                            "ND",
                            "MP",
                            "OH",
                            "OK",
                            "OR",
                            "PA",
                            "PR",
                            "RI",
                            "SC",
                            "SD",
                            "TN",
                            "TX",
                            "UT",
                            "VT",
                            "VI",
                            "VA",
                            "WA",
                            "WV",
                            "WI",
                            "WY"
                        ],
                        "type": "string",
                        "description": "Restrict to a US state/territory (mode=registrants: registrant's state; mode=filings, clients: client's state).",
                        "default": ""
                    },
                    "contributionType": {
                        "title": "Contribution type",
                        "enum": [
                            "",
                            "feca",
                            "he",
                            "me",
                            "ple",
                            "pic"
                        ],
                        "type": "string",
                        "description": "Restrict LD-203 contributions to a specific type (mode=contributions).",
                        "default": ""
                    },
                    "contributorName": {
                        "title": "Contributor name",
                        "type": "string",
                        "description": "Filter LD-203 contribution items by contributor name (mode=contributions)."
                    },
                    "payeeName": {
                        "title": "Payee name",
                        "type": "string",
                        "description": "Filter LD-203 contribution items by payee name (mode=contributions)."
                    },
                    "honoreeName": {
                        "title": "Honoree name",
                        "type": "string",
                        "description": "Filter LD-203 contribution items by the honoree (e.g. the campaign/politician honored) (mode=contributions)."
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "maximum": 2000,
                        "type": "integer",
                        "description": "Hard cap on emitted records.",
                        "default": 20
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Optional. The LDA API is fully open; proxy is only used as an automatic fallback if the API ever rate-limits or blocks the datacenter IP.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
