scrapebench

← Health board

New York Contractor License Lookup & Leads Scraper

New York home improvement contractor licences from NYC, Westchester, Nassau and Buffalo in one dataset: status, expiry, phone and address, by city or licence number.

70%golden-diff pass
Run it on Apify → verified nightly

Verification

70%golden-diff success
10canary runs
0days since last canary run

Output fields

Authoritative field set from the dataset schema.

FieldType
source_urlstring|number|array|object|null
listing_idstring|number|array|object|null
namestring|number|array|object|null
phonestring|number|array|object|null
phone_e164string|number|array|object|null
emailstring|number|array|object|null
websitestring|number|array|object|null
streetstring|number|array|object|null
citystring|number|array|object|null
regionstring|number|array|object|null
postal_codestring|number|array|object|null
countrystring|number|array|object|null
categorystring|number|array|object|null
categoriesstring|number|array|object|null
latstring|number|array|object|null
lngstring|number|array|object|null
sourcestring|number|array|object|null
extrasstring|number|array|object|null
noticestring|null

Sample row

{
  "listing_id": "0760935-DCA",
  "name": "ALL TYPE SIDING & ROOFING INC.",
  "phone": "7187456718",
  "phone_e164": "+17187456718",
  "street": "814 64TH ST",
  "city": "BROOKLYN",
  "region": "NY",
  "postal_code": "11220",
  "country": "US",
  "category": "home improvement contractor",
  "categories": [
    "home improvement contractor"
  ],
  "lat": 40.63289693131491,
  "lng": -74.01136331221319,
  "source": "snapshot",
  "source_url": "https://data.cityofnewyork.us/resource/w7w3-xahh.json?license_nbr=0760935-DCA",
  "extras": {
    "locality": "nyc",
    "status": "Active",
    "expires": "2027-02-28",
    "dba": "ROCCO'S ALL TYPE ROOFING",
    "borough": "Brooklyn",
    "licensed_since": "2003-02-04"
  }
}

Inputs

FieldTypeReqDefaultDescription
mode string no "auto" export: no names, just filters; returns the whole matching list. lookup / verify: put company names (matched if contained in the company name) or licence numbers (exact) in 'queries'. auto picks the mode for you.
query string no — A business name (or listing number) to look up in the stored copy of the directory. Kept alongside 'queries' for saved tasks.
queries array no [] A business name (or listing number) to look up in the stored copy of the directory. Several values in one run; combined with 'query'.
status string no — Only listings in this status. Kept alongside 'statuses' for saved tasks.
statuses array no [] Only listings in this status. Several values in one run; combined with 'status'.
city string no — Only listings in this city. Kept alongside 'cities' for saved tasks.
cities array no [] Only listings in this city. Several values in one run; combined with 'city'.
categories array no [] Only rows from this locality (one or more). Available: buffalo, nassau, nyc, westchester.
maxResults integer no 500 Per query in lookup mode; per run in export mode.
proxyConfiguration object no {"useApifyProxy":false} Used only for live lookups; exports read the stored snapshot.

Pricing

Pay per result (dataset-item) — no charge for empty runs.
Example: 1000 contractor licences at $0.004/result ≈ $4.00.

FAQ

Does this cover all of New York State?

No. New York has no statewide contractor licence; home improvement contractors are licensed locally. This dataset covers the four localities that publish a roster: New York City, Westchester County, Nassau County and Buffalo. Suffolk, Rockland, Putnam and other counties are not included.

Where does the data come from?

NYC Department of Consumer and Worker Protection licences (NYC Open Data), Westchester County's Licensed Contractors map, Nassau County Consumer Affairs' licensed vendor report, and the City of Buffalo's contractor licences (Buffalo Open Data).

How do I get only one area?

Set categories to one or more of nyc, westchester, nassau and buffalo, and city to the cities you want. Cities match the address on the licence, so a Brooklyn firm licensed by Nassau County is included in a Brooklyn search.

How do I get only active contractors?

Set status to Active. Westchester and Buffalo publish only an expiry date; a licence whose date has passed is returned as Expired with a status_note saying the status came from the date.

Can I verify a licence number?

Yes, for NYC (e.g. 0760935-DCA) and Nassau (e.g. H3811010000) numbers. Put one or more in queries. Westchester and Buffalo issue no public licence number; search those by company name.

How current is it?

The rosters were read on 2026-10-27. NYC's own dataset was last updated by the city on 2026-08-20. The stored copy is refreshed when it is older than a month and the actor is in use. The run log states the date of the copy, and a run served from a copy older than 45 days returns one free notice saying so.

How am I charged?

One event per licence returned. Notices are free.

Guides & use cases

Run New York Contractor License Lookup & Leads Scraper on Apify →