Checkbook NYC Contracts Scraper: City Vendors & Agencies

What does Checkbook NYC Contracts Scraper do?

Returns New York City government contracts from Checkbook NYC, the city comptroller's public spending portal. Each record has the vendor, contracting agency, purpose, current and original amount, spend to date, start and end dates, contract type, award method, industry and M/WBE category. Filter by purpose keyword, agency, start date window and contract amount so runs stay small. Pricing is per result.

Data source

The public Checkbook NYC XML API at checkbooknyc.com/api, queried anonymously. Data is as fresh as the city's own publication, typically updated daily.

Why use it?

• Lead generation for city vendors: find who holds contracts in your category, how large they are and when they expire.
• Rebid tracking: filter by end date window to see contracts approaching renewal.
• Competitor research: see which agencies buy from which vendors and at what size.
• M/WBE and small business prospecting: every record carries the vendor's M/WBE category.
• Replaces manual browsing of the portal and spreadsheet exports.

How to use it

1. Open the Actor and set the filters.
2. Click Start. Download results as JSON, CSV or Excel, or read them through the API.
3. Add a Schedule and an Integration (Slack, Google Sheets, webhook) to get new records automatically.

Input

Field	Description
keywords	Words matched against the contract purpose. One search per keyword. Empty means all.
agencyCodes	Limit to city agencies chosen from a list. Empty means all.
startDateFrom / startDateTo	Contract start date window, YYYY-MM-DD.
minAmount / maxAmount	Current contract amount range in USD.
status	registered (approved) or pending.
includeSubVendors	Also return one extra record per subcontractor. Default off.
maxResults	Hard stop for the run. You are billed per result, so this caps the cost.
proxyConfiguration	Optional. The API works without a proxy.

Example input:

{ "keywords": ["software"], "startDateFrom": "2025-01-01", "minAmount": 100000, "maxResults": 50 }

Output

Every record has the same shape:

{
  "id": "MA104020279775680",
  "contractId": "MA104020279775680",
  "vendor": "MCGRAW HILL LLC",
  "agency": "Department of Education",
  "purpose": "Educational software",
  "currentAmount": 773200,
  "originalAmount": 773200,
  "spentToDate": 191951.71,
  "startDate": "2026-09-01",
  "endDate": "2027-08-31",
  "registrationDate": "2026-07-31",
  "contractType": "DEPT OF ED-REQUIREMENT CONTRACT",
  "awardMethod": "RENEWAL OF CONTRACT",
  "industry": "Goods",
  "mwbeCategory": "Non-M/WBE",
  "pin": "R1412",
  "version": 2,
  "womanOwned": false,
  "emergingBusiness": false,
  "vendorRecordType": "Prime Vendor",
  "scrapedAt": "2026-10-17T08:33:02.962Z"
}

Field	Meaning
id	Stable key (contract id), safe for deduplication between runs
vendor, agency, purpose	Who holds the contract, who buys, and what for
currentAmount, originalAmount, spentToDate	Dollar values
startDate, endDate, registrationDate	ISO dates
contractType, awardMethod, industry	Classification from the city
mwbeCategory	Minority and women owned business category of the vendor

Pricing

Pay per event: a small fee when a run starts, then a fixed price per result returned. You only pay for records that pass your filters. Set maxResults to cap any run.

Limitations

• Covers expense contracts only, not revenue or other contract categories.
• Vendor name is not a server side filter in the city API. Use purpose keywords, agency and amount filters instead.
• Agency list covers the main city agencies. Others can be added on request.
• Subcontractor fields are filled only when includeSubVendors is on and the contract reports them.

FAQ

Is this legal? The Actor reads listings the site publishes for any visitor without a login and stores only business information published for that purpose. You are responsible for how you use the data.

Something is missing or broken? Open an issue in the Issues tab; response time is usually under a day.