BuildZoom contractor API

Use the BuildZoom contractor API to retrieve public contractor profiles and source-listed licence or business information. Provide source-page slug (slug). Public contractor information connects location and trade with the licence, rating or profile details exposed by BuildZoom, supporting comparison before a particular permit record is inspected separately. Compare contractors' public profiles, inspect listed licence information and identify candidates for a local construction project. The detail page provides the supported parameters, request examples, available response examples and usage pricing for this operation.

Selected price
$0.002 / billing creditPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Contractor slug or buildzoom.com/contractor/... URL.
Optional parameters (5)
0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
1 skips the 24-hour cache and fetches live.
JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON exports are not exposed.
Native CSV/NDJSON record selector; it has no effect on this JSON-only product.

Sample response

{
  "activity_by_year": [
    {
      "label": "2026",
      "projects": 17,
      "text": "17 projects"
    },
    {
      "label": "2025",
      "projects": 39,
      "text": "39 projects"
    },
    "… 2 more"
  ],
  "activity_note": "Our building permit records indicate that Rex Roofing LLC has worked on at least 172.0 projects over the past 3 years. This is an overview o…",
  "address": {
    "city": "Sebring",
    "country": "US",
    "postal_code": "33876",
    "state": "FL",
    "street": "432 Meadowland Rd"
  },
  "cached": false,
  "credentials": [
    {
      "issuer": "Highlands County Board of County Commissioners",
      "number": "HC03733",
      "type": "Certified Roofing",
      "valid_in": "Highlands County"
    },
    {
      "issuer": "Orange County Public Schools",
      "number": "CCC1331245",
      "type": "B  Roofing Unlimited",
      "valid_in": "Orange County"
    },
    "… 4 more"
  ],
  "credits_used": 1,
  "description": "Our Services include re-roofs on metal, shingle, tile, torch down modified, TPO, aluminum soffit & fascia, and seamless gutters! We are prou…",
  "employees": [
    {
      "name": "Salvador Zuniga",
      "role": "Owner"
    },
    {
      "name": "Zuniga Salvador",
      "role": "Owner"
    }
  ],
  "id": 90650427,
  "job_value_not_public": 27,
  "job_values": [
    {
      "label": "< $5k",
      "projects": 5,
      "text": "5 projects"
    },
    {
      "label": "$5k-$20k",
      "projects": 92,
      "text": "92 projects"
    },
    "… 5 more"
  ],
  "job_values_note": "The typical size of their permits is approximately $17,000. This graph shows the distribution of these job values.",
  "licenses": [
    {
      "board": "Highlands County Board of County Commissioners",
      "business_type": "Limited Liability Company (Llc)",
      "city": null,
      "county": "Highlands County",
      "expires": "September, 2026",
      "label": "License Not Verified",
      "number": "HC03733",
      "state": null,
      "status": "Active",
      "type": "Certified Roofing"
    },
    {
      "board": "Florida Department of Business & Professional Regulation",
      "business_type": "Limited Liability Company (Llc)",
      "city": null,
      "county": null,
      "expires": "December, 2025",
      "label": "License Not Verified",
      "number": null,
      "state": "Florida",
      "status": "Active",
      "type": "Construction Business Information"
    },
    "… 4 more"
  ],
  "logo": "https://media.buildzoom.com/filestack/image/yzvL60cTSUeD5dzFp72E",
  "name": "Rex Roofing LLC",
  "permits_sample": [
    {
      "address": "115 Old Bowling Green Rd, Bowling Green, FL, 33834",
      "building_type": null,
      "date": "2025-09-18",
      "description": "New single family home",
      "fee": 6103,
      "permit_number": "BR-2025-3672",
      "permit_type": null,
      "property_url": "https://www.buildzoom.com/property-info/115-old-bowling-green-rd-bowling-green-fl",
      "status": "complete",
      "title": "Residential new permit - ex: new house",
      "valuation": 280013
    },
    {
      "address": "2693 SW Thigpen Ave, Arcadia, FL, 34266",
      "building_type": null,
      "date": "2025-08-21",
      "description": "New construction (sfr)",
      "fee": 3019,
      "permit_number": "BLDR-25349-2025",
      "permit_type": null,
      "property_url": "https://www.buildzoom.com/property-info/2693-sw-thigpen-ave-arcadia-fl",
      "status": "issued",
      "title": "Building (residential) - new construction",
      "valuation": 359061
    },
    "… 18 more"
  ],
  "permits_total": 445,
  "phone": "+1 555 010 0000",
  "price_range": null,
  "project_types": [
    {
      "label": "New Constructions",
      "projects": 6,
      "text": "6 projects"
    },
    {
      "label": "Commercial Renovations",
      "projects": 3,
      "text": "3 projects"
    },
    "… 1 more"
  ],
  "project_types_note": "Analyzing permits over the last 4 years shows that Rex Roofing LLC mostly works on roofing project and new construction projects.",
  "rating": 4,
  "review_count": 4,
  "reviews": [
    {
      "author": "Savi T.",
      "date": "February 20, 2019",
      "id": "8161481",
      "rating": 1,
      "subject": "Roofing project",
      "text": "Rex was very responsive in the beginning. Then there was no direction. The work was supposed to be done but never advise us of the date when…",
      "verified_hire": true
    },
    {
      "author": "Philip B.",
      "date": "May 30, 2018",
      "id": "8129488",
      "rating": 5,
      "subject": null,
      "text": "THEY ARE THE BEST ROOFERS THAT I COULD HAVE HOPED. WE AGREED ON A COPPER METALLIC ROOF WHICH TURNED OUT BEUTIFULLY. THEY ARE KNOWLEDGEABLE, …",
      "verified_hire": false
    },
    "… 2 more"
  ],
  "score": 0,
  "score_badge": "ALERT*",
  "score_note": "*No active license on file. If you are Rex Roofing LLC, log in and update your license info in the “Edit Profile” tab.",
  "score_percentile": 1,
  "services": [
    "Roofing",
    "Gutters and Flashing",
    "… 1 more"
  ],
  "slug": "rex-roofing-llc",
  "type": "RoofingContractor",
  "url": "https://www.buildzoom.com/contractor/rex-roofing-llc"
}

Response result

Response structure

Inferred from examples
  • activity_by_year(object | string)[]
    • labelstring
    • projectsinteger
    • textstring
  • activity_notestring
  • addressobject
    • citystring
    • countrystring
    • postal_codestring
    • statestring
    • streetstring
  • cachedboolean
  • credentials(object | string)[]
    • issuerstring
    • numberstring
    • typestring
    • valid_instring
  • credits_usedinteger
  • descriptionstring
  • employeesobject[]
    • namestring
    • rolestring
  • idinteger
  • job_value_not_publicinteger
  • job_values(object | string)[]
    • labelstring
    • projectsinteger
    • textstring
  • job_values_notestring
  • licenses(object | string)[]
    • boardstring
    • business_typestring
    • citynull
    • countystring | null
    • expiresstring
    • labelstring
    • numberstring | null
    • statenull | string
    • statusstring
    • typestring
  • logostring
  • namestring
  • permits_sample(object | string)[]
    • addressstring
    • building_typenull
    • datestring
    • descriptionstring
    • feeinteger
    • permit_numberstring
    • permit_typenull
    • property_urlstring
    • statusstring
    • titlestring
    • valuationinteger
  • permits_totalinteger
  • phonestring
  • price_rangenull
  • project_types(object | string)[]
    • labelstring
    • projectsinteger
    • textstring
  • project_types_notestring
  • ratinginteger
  • review_countinteger
  • reviews(object | string)[]
    • authorstring
    • datestring
    • idstring
    • ratinginteger
    • subjectstring | null
    • textstring
    • verified_hireboolean
  • scoreinteger
  • score_badgestring
  • score_notestring
  • score_percentileinteger
  • servicesstring[]
  • slugstring
  • typestring
  • urlstring

Loading related APIs…

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use BuildZoom contractor API with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.