thebluebook.com APIthebluebook.com ↗
Search and retrieve commercial contractor profiles from The Blue Book Network. Filter by CSI trade code, region, keyword, and get full company details.
curl -X GET 'https://api.parse.bot/scraper/ece15523-b39d-42ad-96c3-9240ef62b597/search_companies?query=HVAC®ion_id=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for commercial construction companies by keyword. Returns a list of matching companies with their IDs and names. Results can be filtered by region and CSI trade code.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'HVAC', 'plumbing', 'electrical contractor'). |
| csi_code | string | CSI trade code for filtering results (e.g. '1680' for Electrical Contractors). Obtain codes from list_categories endpoint. |
| region_id | string | Region ID to filter by geographic area (e.g. '1' for New York - NYC region). Obtain IDs from list_regions endpoint. |
{
"type": "object",
"fields": {
"results": "array of company objects with company_id, name, and location",
"total_count": "integer total number of matching companies"
},
"sample": {
"data": {
"results": [
{
"name": "Joe Lombardo Plumbing & Heating of Rockland, Inc.",
"location": "",
"company_id": "398517"
},
{
"name": "Mechanical Solutions, Inc.",
"location": "",
"company_id": "808224"
}
],
"total_count": 983
},
"status": "success"
}
}About the thebluebook.com API
This API provides 4 endpoints for searching and retrieving contractor profiles from The Blue Book Building & Construction Network, covering company names, addresses, phone numbers, websites, trade specialties, and CSI codes. Use search_companies to find matching contractors by keyword with optional filters for trade category and geographic region, then fetch full profiles with get_company_detail.
Search and Filter Commercial Contractors
The search_companies endpoint accepts a query string (e.g. "HVAC", "plumbing", "electrical contractor") and returns an array of matching companies, each with a company_id, name, and location. Two optional parameters let you narrow results: csi_code filters by CSI trade division (e.g. 1680 for electrical contractors), and region_id filters by geographic area. Both values are discoverable through the list_categories and list_regions endpoints respectively. The response also includes a total_count integer representing the full result set size.
Full Company Profiles
Once you have a company_id, pass it to get_company_detail to retrieve the complete company record. The response includes name, phone, address (city/state/zip), website, company_id, a description field containing the company's profile text, and a specialties array listing the trades or services the company self-reports. This is the primary endpoint for building enriched contractor records.
Reference Data: Regions and Categories
The list_regions endpoint returns all available Blue Book geographic regions as objects containing id, city, state, zip, region, booksplitlabel, and recordcnt. Pass a query string to filter by region name, or use the default **** to return the full list. The list_categories endpoint takes no inputs and returns all trade categories as objects with name and code fields — these codes map directly to the csi_code parameter in search_companies, letting you programmatically enumerate and filter across every trade division The Blue Book recognizes.
- Build a searchable directory of commercial contractors filtered by CSI trade code and metropolitan region
- Enrich CRM records with verified phone numbers, addresses, and websites from contractor profiles
- Map trade specialty coverage across geographic regions using
region_idandspecialtiesfields - Generate lead lists of HVAC, plumbing, or electrical contractors in a target city using keyword and region filters
- Monitor which CSI trade categories have the highest contractor density via
total_countacross regions - Populate a vendor qualification database with company descriptions and specialty arrays from
get_company_detail
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does The Blue Book have an official developer API?+
What does `get_company_detail` return beyond what `search_companies` provides?+
search_companies returns only company_id, name, and location per result. get_company_detail adds phone, website, a description narrative, and a specialties array listing the specific trades the company reports. The detail endpoint is required to retrieve any contact or trade information.How do I find the right `region_id` or `csi_code` to filter my search?+
list_regions to browse all geographic regions — each object includes the region's id field, which maps to the region_id parameter in search_companies. Use list_categories to enumerate all trade categories and their code values, which map to the csi_code parameter. Both endpoints are designed to be called first to populate filter options.Does the API return contractor reviews, ratings, or project history?+
Is pagination supported for large search result sets?+
search_companies returns a total_count indicating how many companies match the query, but the current endpoints do not expose a page or offset parameter for stepping through large result sets. You can fork this API on Parse and revise it to add pagination support.