# Measured Bid developer docs

How to put the Measured Bid price widget on a website, track it, and send its leads where you need them. Written for web developers, people setting up a site builder, and AI assistants.

Source: https://measuredbid.com/docs

## Add the widget in three steps

1. **Copy the code.** In Measured Bid, open Widgets, pick the widget and open Install. Copy the Website code. It already has the widget ID in it.
2. **List the website.** In the widget's settings, under Websites, add each address the widget will appear on, one per line, like `https://example.com`. The widget stays blank anywhere else.
3. **Paste it.** Put the code where the price form should appear, in an HTML or code block. It sizes itself. [Where to paste it on each platform](https://measuredbid.com/docs/embed#platforms).

> **No developer? Use the link.** Every widget also has a homeowner link, like `https://measuredbid.com/quote/your-widget-id`. It works anywhere without code: a button on your site, a text message, your Google Business Profile. [More on links](https://measuredbid.com/docs/embed#link).

## How it works

- The widget is a page on measuredbid.com shown in an iframe on your site.
- A homeowner types an address, confirms the house, answers a few questions and sees a price range built from the contractor's rates.
- When they send the form, the lead is saved in the Measured Bid dashboard and sent to the contractor's email, texts, webhook or CRM, whichever are set up.
- Prices, questions, colors and service area come from the dashboard. Changes show on your site within a minute, with no need to paste the code again.

## What's in these docs

| Page | Use it to |
| --- | --- |
| [Embed the widget](https://measuredbid.com/docs/embed) | Paste the code on any site or site builder, allow the site, use a link instead, test it. |
| [URL parameters](https://measuredbid.com/docs/url-parameters) | Prefill the address, open on one trade, carry ad tracking into the lead. |
| [Events and tracking](https://measuredbid.com/docs/events) | Track widget steps in Google Tag Manager, GA4 or your own code. |
| [Webhooks](https://measuredbid.com/docs/webhooks) | Receive each new lead as JSON, and receive stage changes for leads you sent in. |
| [Sending leads in](https://measuredbid.com/docs/lead-intake) | Post leads from other forms or a CRM into Measured Bid, and update their stage. |
| [Troubleshooting](https://measuredbid.com/docs/troubleshooting) | Fix a blank widget, a cut-off frame, missing prices or missing leads. |

## Is there an API?

There is no public API for prices. Homeowners get prices through the widget. For lead data there are two webhooks Measured Bid sends and one URL it receives: [new leads and lead updates out](https://measuredbid.com/docs/webhooks), and [form leads and stage updates in](https://measuredbid.com/docs/lead-intake).

## For AI assistants

Every page has a plain Markdown version: add `.md` to its address, like [/docs/embed.md](https://measuredbid.com/docs/embed.md). All pages in one file: [/llms-full.txt](https://measuredbid.com/llms-full.txt). You can hand an assistant a prompt like this:

Prompt:

```text
Read https://measuredbid.com/llms-full.txt. Then add my Measured Bid widget (ID: your-widget-id) to my website's quote page, and tell me which website addresses to add under Websites in the widget's settings.
```

Questions: [support@measuredbid.com](mailto:support@measuredbid.com).
