# US UCC Filings Scraper - Secured-Loan & Lender Leads (`scrapesage/us-ucc-filings-scraper`) Actor
Scrape UCC-1 financing statements from official state portals (CT, CO, OR): debtor business, secured party/lender, collateral, filing & lapse dates, lien type & lead score. Fresh secured-loan B2B leads for equipment finance, MCA, factoring & lending. Filters + monitoring, no browser.
- **URL**: https://apify.com/scrapesage/us-ucc-filings-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
$5.00 / 1,000 ucc filing records
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/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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
## US UCC Filings Scraper — Secured-Loan & Lender Leads (Debtor, Collateral & Lead Score)
Extract **UCC-1 financing statements** from official US state Secretary-of-State open-data portals and turn each one into a **fresh, high-intent B2B financing lead**. Every UCC filing means a business just pledged collateral for a secured loan — exactly the buying signal that **equipment-finance lenders, merchant cash advance (MCA) funders, factoring companies, commercial lenders and brokers** prospect on every day.
Each record ships the **debtor (the borrowing business)** with mailing address, the **secured party / lender(s)**, the **collateral financed**, the **filing and lapse dates**, the lien category, status and a derived **0–100 lead score** with intent signals.
No login, no cookies, no browser, no API key — fast JSON extraction straight from official state data, with **daily-fresh filings**.
### Why this UCC scraper?
UCC data is the single best public financing-intent signal — but the existing scrapers are single-state, often abandoned, and return a thin lien stub with no lender, no collateral, and no lead scoring. This actor unifies **multiple states into one schema** and ships the **richest UCC dataset in the category**:
| Data | Typical scrapers | This actor |
|---|---|---|
| Multiple states in one run (CT + CO + OR) | ❌ single state | ✅ unified schema |
| Debtor business name + full mailing address | partial | ✅ |
| Secured party / **lender** name + address | ❌ | ✅ |
| **Collateral financed** (equipment, vehicles, livestock, inventory…) | ❌ | ✅ (CO) |
| Original-financing-statement vs amendment/continuation | ❌ | ✅ |
| Lapse date + **days-until-lapse** (refinance timing) | ❌ | ✅ |
| Lien category (UCC, farm EFS, tax, judgment, hospital) | ❌ | ✅ |
| Find every business financed by a **specific lender** | ❌ | ✅ |
| Lead score (0–100) + intent signals | ❌ | ✅ |
| Only-new **monitoring mode** for fresh filings | ❌ | ✅ |
| Link to the official scanned filing image (OR) | ❌ | ✅ |
### Use cases
- **Equipment-finance & lending lead-gen** — every UCC-1 original is a business that just financed equipment, vehicles, or working capital. Reach them for the *next* deal, a refinance, or an add-on. Filter `filingCategory: "originals"` + `debtorType: "business"` and sort newest-first.
- **Refinance & renewal timing** — a UCC lapses ~5 years after filing. Use `lapsingWithinDays` to find businesses whose financing is about to expire and pitch a refinance before the incumbent lender re-files.
- **Competitive intelligence** — use `securedPartyContains` to pull every business a competitor (a bank, captive lender, or MCA funder) has financed — their whole book, with contact addresses.
- **Merchant cash advance & factoring** — businesses with active secured filings are proven credit users; segment by collateral type, geography, and recency.
- **Market & portfolio intelligence** — track filing velocity by lender, collateral type, and state; benchmark your origination share.
- **CRM enrichment & monitoring** — schedule daily runs in monitoring mode to capture brand-new filings the moment the state publishes them.
### How to use
1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **US UCC Filings Scraper**, choose your **states** and filters (filing category, debtor type, date range, lender, collateral), and click **Start**.
3. Watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2).
### Input
```json
{
"states": ["CT", "CO", "OR"],
"filingCategory": "originals",
"debtorType": "business",
"statusActiveOnly": true,
"filingDateFrom": "2026-06-01",
"maxResults": 1000,
"sortNewestFirst": true
}
````
- **states** — official state portals to query: `CT` (842K filings, updated daily, debtor + secured party in one record), `CO` (2.5M filings joined to debtor + secured party + collateral, daily), `OR` (rolling "filings entered last month" feed — the freshest leads).
- **filingCategory** — `originals` (brand-new financing statements = new loans, recommended), `ucc` (all UCC + farm filings incl. amendments), or `all` (also tax / judgment / hospital liens).
- **debtorType** — `business` (B2B, recommended), `individual`, or `all`.
- **statusActiveOnly** *(default true)* — only currently-active filings (not terminated/released/lapsed).
- **filingDateFrom / filingDateTo** — date window for fresh leads (`YYYY-MM-DD`).
- **lapsingWithinDays** — only active filings lapsing within N days — perfect for refinance/renewal timing.
- **debtorStates** — filter by the debtor's mailing-address state.
- **debtorNameContains** — only debtors whose name contains this text.
- **securedPartyContains** — only filings whose lender name contains this text (competitive prospecting).
- **collateralKeywords** — filter Colorado filings by collateral text (`equipment`, `vehicle`, `inventory`, `livestock`, `accounts`).
- **includeSecuredParties / includeCollateral** *(default true)* — toggle the lender and collateral arrays.
- **maxResults / maxResultsPerState / sortNewestFirst / deduplicateResults** — output controls.
- **monitorMode / monitorKey** — only emit filings new since the last run (see below).
### Output
One record per debtor on a UCC filing (`recordType: "uccFiling"`):
```json
{
"recordType": "uccFiling",
"state": "CT",
"source": "Connecticut Secretary of the State — UCC Lien Filings (data.ct.gov)",
"filingNumber": "0005391022",
"fileId": "0005391022",
"filingType": "Original Financing Statement",
"filingTypeRaw": "ORIG FIN STMT",
"documentType": "OFS",
"lienCategory": "UCC",
"isOriginal": true,
"status": "Active",
"active": true,
"filingDate": "2026-06-19",
"lapseDate": "2031-06-19",
"daysUntilLapse": 1824,
"nearLapse": false,
"debtorName": "CARRIER GROUP, INC.",
"debtorIsBusiness": true,
"debtorStreet": "68 S CANAL ST # A",
"debtorCity": "Plainville",
"debtorState": "CT",
"debtorZip": "06062",
"debtorAddressFull": "68 S CANAL ST # A, Plainville, CT 06062",
"primarySecuredParty": "John Deere Construction & Forestry Company",
"securedPartyCount": 1,
"securedParties": [
{
"name": "John Deere Construction & Forestry Company",
"isBusiness": true,
"city": "Johnston",
"state": "IA",
"zipCode": "50131",
"addressFull": "6400 NW 86th St, Johnston, IA 50131"
}
],
"collateralCount": 0,
"collateralSummary": null,
"collateral": [],
"recordUrl": null,
"verifyUrl": "https://service.ct.gov/business/s/onlinebusinesssearch",
"leadScore": 88,
"leadSignals": ["fresh_filing", "business_debtor", "original_filing", "named_lender", "street_address"],
"scrapedAt": "2026-06-20T12:00:00.000Z"
}
```
Colorado records additionally carry **collateral** detail (e.g. `"KUBOTA SVL75-3HFWVRCC … TRACK LOADER"`, `"92 HEAD OF LIVESTOCK"`) and the secured-party/collateral arrays; Oregon records carry a `recordUrl` link to the official scanned filing image.
### Monitoring — only new filings
Turn on **`monitorMode`** to remember which filings you've already seen (in a named key-value store) and emit **only filings new since the last run**, each tagged `monitorEvent: "new"`. State portals refresh daily (CT, CO) or monthly (OR), so a scheduled run captures freshly-filed secured loans the moment they appear.
Monitoring works **alongside** Apify Schedules, not against them: the [Schedule](https://docs.apify.com/platform/schedules) *starts* the run on your cadence; monitoring mode decides *what's new* inside that run, so you never pay for or re-import duplicates. Use a distinct `monitorKey` per saved watch (e.g. per state or filter set).
### Automate & schedule
Run this actor on autopilot and pull results into your own stack:
- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly with `monitorMode` to capture new secured-loan filings as fresh leads.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, dialer queue) the moment a run finishes.
```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });
const run = await client.actor('scrapesage/us-ucc-filings-scraper').call({
states: ['CT', 'CO', 'OR'],
filingCategory: 'originals',
debtorType: 'business',
filingDateFrom: '2026-06-01',
maxResults: 1000,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} UCC financing-statement leads`);
```
### Integrate with any app
Connect the dataset to 5,000+ apps — no code required:
- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new debtor leads straight into your CRM.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds new filings.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.
### Use with AI assistants (MCP)
The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find Colorado businesses that financed equipment with Kubota in the last 30 days" and let it run this scraper for you.
### Agent-ready: autonomous payments (x402 & Skyfire)
This actor is **agent-ready** — AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards:
- **[x402](https://docs.apify.com/platform/integrations/x402)** — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — no account, no API key.
- **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** — agent-to-service payments for fully autonomous AI-agent workflows.
Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.
### More US B2B lead-gen scrapers from scrapesage
Build a complete **financing & business-intent lead stack** from official US data:
- **[SBA Loan Leads Scraper](https://apify.com/scrapesage/sba-loan-leads-scraper)** — SBA 7(a) & 504 financed small businesses (borrower, lender, amount, jobs).
- **[PPP Loan Data Scraper](https://apify.com/scrapesage/ppp-loan-data-scraper)** — 11.5M PPP loans with owner demographics, NAICS & forgiveness.
- **[SEC Form D Funding Scraper](https://apify.com/scrapesage/sec-form-d-funding-scraper)** — private-placement & Reg CF raises with named founders.
- **[US Business Formation Scraper](https://apify.com/scrapesage/us-business-formation-scraper)** — newly registered companies (registration intent).
- **[US Banks & Credit Unions Scraper](https://apify.com/scrapesage/us-banks-credit-unions-scraper)** — FDIC banks + NCUA credit unions in one schema.
- **[Form 5500 ERISA Scraper](https://apify.com/scrapesage/form-5500-erisa-scraper)** — 401(k)/benefit-plan sponsors, advisors & providers.
- **[US Professional License Scraper](https://apify.com/scrapesage/us-professional-license-scraper)** — licensed professionals & businesses across states.
- **[FMCSA Trucking Scraper](https://apify.com/scrapesage/fmcsa-trucking-scraper)** — motor carriers & owner-operators (DOT/MC).
- **[Financial Advisor Scraper](https://apify.com/scrapesage/financial-advisor-scraper)** — SEC/FINRA-registered advisors & firms.
### Tips
- **Freshest leads**: keep `sortNewestFirst: true` and set a recent `filingDateFrom` (or add `monitorMode`) — CT and CO publish new filings daily, Oregon ships a rolling "last month" feed.
- **Refinance lists**: combine `statusActiveOnly: true` with `lapsingWithinDays: 180` to find businesses whose financing expires soon.
- **Whole-book intel**: `securedPartyContains` returns every debtor a given lender has financed — great for poaching or partnership lists.
- **Collateral targeting**: Colorado publishes itemized collateral — use `collateralKeywords` (`equipment`, `vehicle`, `livestock`, `inventory`) to focus on the assets you finance.
- **Cost control**: set `maxResults` and/or `maxResultsPerState`; turn off `includeCollateral` for leaner Colorado runs.
### FAQ
**What is a UCC filing and why is it a sales lead?** A UCC-1 financing statement is the public notice a lender files when a business pledges collateral for a secured loan. It proves the business is an active, qualified credit user — the strongest public buying signal for anyone selling financing, equipment, or working capital.
**Which states are covered?** Connecticut, Colorado and Oregon — the states that publish complete UCC data as official open data (no login, no captcha). Each is normalized into one shared schema. More states are added over time.
**How fresh is the data?** Connecticut and Colorado are updated daily (filings from yesterday appear), and Oregon ships a rolling "filings entered last month" feed. Use `monitorMode` on a daily schedule to capture new filings continuously.
**Where do the lender and collateral come from?** Directly from the state filing: the secured party (lender) name and address, and — for Colorado — the itemized collateral description (often including equipment make/model and serial numbers).
**Can I find every business a specific lender financed?** Yes — set `securedPartyContains` to the lender's name (e.g. `Stearns Bank`, `Kubota`, `Wells Fargo`).
**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).
**Is this legal?** This actor collects publicly available government records only (UCC filings are public by law). You are responsible for using the data in compliance with applicable laws and each state's terms.
**A field is null — why?** Some filings genuinely omit a street address, lender, or collateral. Fields are `null` only when the source record doesn't contain them, never because the scraper skipped them — every available source field is included.
### Need help?
Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.
# Actor input Schema
## `states` (type: `array`):
Which state UCC datasets to query. Each is an official state Secretary-of-State open-data portal: CT (842K lien filings, updated daily, debtor + secured party in one record), CO (2.5M filings joined to debtor + secured party + collateral, updated daily), OR (rolling 'filings entered last month' feed — the freshest leads). Leave empty for all three.
## `filingCategory` (type: `string`):
Original financing statements = brand-new secured loans (UCC-1 originals + farm EFS) — the highest-intent financing leads. UCC only = all UCC + farm filings incl. amendments/continuations/terminations. All filings = also include IRS tax liens, hospital liens, judgment/vessel/aircraft liens where the state publishes them.
## `debtorType` (type: `string`):
Who the borrower is. Businesses only (organization debtors) = B2B leads (recommended). Individuals only = consumer / sole-proprietor debtors. All = both.
## `statusActiveOnly` (type: `boolean`):
Only return filings that are currently active (not terminated/released, and not yet lapsed). Turn off to include lapsed, released and terminated filings.
## `filingDateFrom` (type: `string`):
Only filings accepted on or after this date, YYYY-MM-DD — great for fresh financing-intent leads (businesses that just took a secured loan).
## `filingDateTo` (type: `string`):
Only filings accepted on or before this date, YYYY-MM-DD.
## `lapsingWithinDays` (type: `integer`):
Only active filings whose lapse (expiration) date is within the next N days — perfect for refinancing / renewal timing outreach (a UCC lapses ~5 years after filing). e.g. 180 for filings lapsing in the next 6 months.
## `debtorStates` (type: `array`):
Filter by the debtor's mailing-address state (2-letter, e.g. CT, NY, MA). Most debtors are in the filing state, but lenders also file against out-of-state businesses.
## `debtorNameContains` (type: `string`):
Only debtors whose name (business or individual) contains this text (case-insensitive).
## `securedPartyContains` (type: `string`):
Only filings whose secured party (lender) name contains this text — e.g. find every business financed by a specific competitor (Stearns Bank, Wells Fargo, CNH) for competitive prospecting.
## `collateralKeywords` (type: `array`):
Filter Colorado filings by collateral description (case-insensitive, any match), e.g. equipment, vehicle, inventory, livestock, accounts. Applies to CO only (the only source that publishes collateral detail); does not restrict CT/OR.
## `includeSecuredParties` (type: `boolean`):
Include the secured party / lender array on each record (lender name + address). Recommended — this is the competitive-intel layer.
## `includeCollateral` (type: `boolean`):
Include the collateral array on Colorado records (what was financed). Turn off for slightly faster, leaner CO runs.
## `maxResults` (type: `integer`):
Maximum number of UCC filing records to return in this run (across all selected states).
## `maxResultsPerState` (type: `integer`):
Cap how many records are pulled from each state before the global limit and sorting are applied. Leave blank to use the same value as Max results.
## `sortNewestFirst` (type: `boolean`):
Return the most recently filed records first (best for fresh leads).
## `deduplicateResults` (type: `boolean`):
Skip duplicate filing/debtor records within this run (recommended).
## `monitorMode` (type: `boolean`):
Remember which filings were already returned (in a named key-value store) and emit ONLY filings that are new since the last run — each tagged monitorEvent: "new". State portals refresh daily/monthly; run on a Schedule to capture newly-filed secured loans as fresh leads the moment they appear. Works alongside Apify Schedules (the schedule starts the run; monitoring decides what's new).
## `monitorKey` (type: `string`):
Names the memory used by monitoring mode. Use a distinct key per saved watch (e.g. per state / filter set) so different monitors don't share state.
## `socrataAppToken` (type: `string`):
Optional Socrata app token for higher rate limits on very large runs. Not required — leave blank for normal use. Get one free at any state open-data portal.
## `proxyConfiguration` (type: `object`):
Optional proxy. State open data is fetched directly and needs no proxy — leave this off for the fastest runs. Enable Apify Proxy only if your network requires it.
## Actor input object example
```json
{
"states": [
"CT",
"CO",
"OR"
],
"filingCategory": "originals",
"debtorType": "business",
"statusActiveOnly": true,
"includeSecuredParties": true,
"includeCollateral": true,
"maxResults": 1000,
"sortNewestFirst": true,
"deduplicateResults": true,
"monitorMode": false,
"monitorKey": "default",
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `results` (type: `string`):
All scraped UCC / lien filing records as JSON items in the default dataset.
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"states": [
"CT",
"CO",
"OR"
],
"proxyConfiguration": {
"useApifyProxy": false
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/us-ucc-filings-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"states": [
"CT",
"CO",
"OR",
],
"proxyConfiguration": { "useApifyProxy": False },
}
# Run the Actor and wait for it to finish
run = client.actor("scrapesage/us-ucc-filings-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 '{
"states": [
"CT",
"CO",
"OR"
],
"proxyConfiguration": {
"useApifyProxy": false
}
}' |
apify call scrapesage/us-ucc-filings-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapesage/us-ucc-filings-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "US UCC Filings Scraper - Secured-Loan & Lender Leads",
"description": "Scrape UCC-1 financing statements from official state portals (CT, CO, OR): debtor business, secured party/lender, collateral, filing & lapse dates, lien type & lead score. Fresh secured-loan B2B leads for equipment finance, MCA, factoring & lending. Filters + monitoring, no browser.",
"version": "0.1",
"x-build-id": "zHha9CJC4a33EwLhh"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~us-ucc-filings-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-us-ucc-filings-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/scrapesage~us-ucc-filings-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-us-ucc-filings-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/scrapesage~us-ucc-filings-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-us-ucc-filings-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",
"properties": {
"states": {
"title": "States",
"type": "array",
"description": "Which state UCC datasets to query. Each is an official state Secretary-of-State open-data portal: CT (842K lien filings, updated daily, debtor + secured party in one record), CO (2.5M filings joined to debtor + secured party + collateral, updated daily), OR (rolling 'filings entered last month' feed — the freshest leads). Leave empty for all three.",
"items": {
"type": "string",
"enum": [
"CT",
"CO",
"OR"
],
"enumTitles": [
"Connecticut (SOTS)",
"Colorado (SOS)",
"Oregon (SOS)"
]
},
"default": [
"CT",
"CO",
"OR"
]
},
"filingCategory": {
"title": "Filing category",
"enum": [
"originals",
"ucc",
"all"
],
"type": "string",
"description": "Original financing statements = brand-new secured loans (UCC-1 originals + farm EFS) — the highest-intent financing leads. UCC only = all UCC + farm filings incl. amendments/continuations/terminations. All filings = also include IRS tax liens, hospital liens, judgment/vessel/aircraft liens where the state publishes them.",
"default": "originals"
},
"debtorType": {
"title": "Debtor type",
"enum": [
"business",
"individual",
"all"
],
"type": "string",
"description": "Who the borrower is. Businesses only (organization debtors) = B2B leads (recommended). Individuals only = consumer / sole-proprietor debtors. All = both.",
"default": "business"
},
"statusActiveOnly": {
"title": "Active filings only",
"type": "boolean",
"description": "Only return filings that are currently active (not terminated/released, and not yet lapsed). Turn off to include lapsed, released and terminated filings.",
"default": true
},
"filingDateFrom": {
"title": "Filed on/after (optional)",
"type": "string",
"description": "Only filings accepted on or after this date, YYYY-MM-DD — great for fresh financing-intent leads (businesses that just took a secured loan)."
},
"filingDateTo": {
"title": "Filed on/before (optional)",
"type": "string",
"description": "Only filings accepted on or before this date, YYYY-MM-DD."
},
"lapsingWithinDays": {
"title": "Lapsing within N days (optional)",
"minimum": 1,
"type": "integer",
"description": "Only active filings whose lapse (expiration) date is within the next N days — perfect for refinancing / renewal timing outreach (a UCC lapses ~5 years after filing). e.g. 180 for filings lapsing in the next 6 months."
},
"debtorStates": {
"title": "Debtor states (optional)",
"type": "array",
"description": "Filter by the debtor's mailing-address state (2-letter, e.g. CT, NY, MA). Most debtors are in the filing state, but lenders also file against out-of-state businesses.",
"items": {
"type": "string"
}
},
"debtorNameContains": {
"title": "Debtor name contains (optional)",
"type": "string",
"description": "Only debtors whose name (business or individual) contains this text (case-insensitive)."
},
"securedPartyContains": {
"title": "Secured party / lender contains (optional)",
"type": "string",
"description": "Only filings whose secured party (lender) name contains this text — e.g. find every business financed by a specific competitor (Stearns Bank, Wells Fargo, CNH) for competitive prospecting."
},
"collateralKeywords": {
"title": "Collateral keywords (Colorado)",
"type": "array",
"description": "Filter Colorado filings by collateral description (case-insensitive, any match), e.g. equipment, vehicle, inventory, livestock, accounts. Applies to CO only (the only source that publishes collateral detail); does not restrict CT/OR.",
"items": {
"type": "string"
}
},
"includeSecuredParties": {
"title": "Include secured parties (lenders)",
"type": "boolean",
"description": "Include the secured party / lender array on each record (lender name + address). Recommended — this is the competitive-intel layer.",
"default": true
},
"includeCollateral": {
"title": "Include collateral detail (Colorado)",
"type": "boolean",
"description": "Include the collateral array on Colorado records (what was financed). Turn off for slightly faster, leaner CO runs.",
"default": true
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"type": "integer",
"description": "Maximum number of UCC filing records to return in this run (across all selected states).",
"default": 1000
},
"maxResultsPerState": {
"title": "Max results per state (optional)",
"minimum": 1,
"type": "integer",
"description": "Cap how many records are pulled from each state before the global limit and sorting are applied. Leave blank to use the same value as Max results."
},
"sortNewestFirst": {
"title": "Newest filings first",
"type": "boolean",
"description": "Return the most recently filed records first (best for fresh leads).",
"default": true
},
"deduplicateResults": {
"title": "Deduplicate within a run",
"type": "boolean",
"description": "Skip duplicate filing/debtor records within this run (recommended).",
"default": true
},
"monitorMode": {
"title": "Monitoring mode — only new filings",
"type": "boolean",
"description": "Remember which filings were already returned (in a named key-value store) and emit ONLY filings that are new since the last run — each tagged monitorEvent: \"new\". State portals refresh daily/monthly; run on a Schedule to capture newly-filed secured loans as fresh leads the moment they appear. Works alongside Apify Schedules (the schedule starts the run; monitoring decides what's new).",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Names the memory used by monitoring mode. Use a distinct key per saved watch (e.g. per state / filter set) so different monitors don't share state.",
"default": "default"
},
"socrataAppToken": {
"title": "Socrata app token (optional)",
"type": "string",
"description": "Optional Socrata app token for higher rate limits on very large runs. Not required — leave blank for normal use. Get one free at any state open-data portal."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional proxy. State open data is fetched directly and needs no proxy — leave this off for the fastest runs. Enable Apify Proxy only if your network requires it.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```