{"auth":{"alt":"X-Api-Key: mb_live_...","header":"Authorization: Bearer mb_live_...","type":"api_key","where":"Members can create keys in Profile and billing under Advanced integrations. Keys are shown once and can be revoked any time."},"coverage":"Lists are available in supported areas of the contiguous United States. Records and measured signals vary by trade and area; /v1/count reports pendingSignals where a signal is not yet processed. A count alone does not guarantee that a list can be purchased. Excluded states: CA, NJ, OR, VT.","description":"Property-data mailing lists for home-service contractors: the leads a contractor picks by what is on the property, not by a form. Count the homes that fit a trade in an area, see the market picture, and buy the list. Available signals come from public satellite and elevation data (tree canopy near the house, brush, slope), public parcel records (lot size), and licensed property records (home size, year built, sale date, pool). Availability varies by trade and area.","docs":"https://meadleybrothers.com/api/","endpoints":[{"body":{"city":"with state, instead of zip","lat":"number","lng":"number","radiusMiles":"0.5 to 50","recipientMode":"optional: owner_property (default), owner name at the property address; owner, the owner's own mailing address; resident, Current Resident at the property address","state":"two-letter, with city","strategyIds":"optional, from a trade's strategies","trade":"slug from trades","zip":"five-digit ZIP at the center (or city plus state, or lat and lng)"},"method":"POST","path":"/v1/count","purpose":"How many deduplicated households match. Free; counts toward the key's daily quota.","returns":{"count":"integer","pendingSignals":"signals not yet processed for this area, if any","status":"ready or a reason the count is not yet measured","unit":"deduplicated households"}},{"method":"POST","path":"/v1/preview","purpose":"The measured count for the cards you choose, plus every strategy card the trade offers (id, name, whether it is the widest) so you can narrow, and which measured signals are ready in this area. Same body as /v1/count, plus optional strategyIds."},{"body":{"...":"same as /v1/count","listName":"optional","quantity":"addresses to buy, 1,000 minimum"},"method":"POST","path":"/v1/checkout","purpose":"Buy the list. Returns a Stripe Checkout URL; send your user there. The API never handles card details. The list (owner names and mailing addresses as an Excel workbook plus a printer-format CSV) is delivered to the user's Meadley Bros. account and they are emailed when the file is ready. Card payment. Download availability is shown in the account.","returns":{"checkoutUrl":"Stripe Checkout; after paying the user lands on the Meadley Bros. thank-you page where the file appears","orderId":"uuid"}}],"limits":{"addressesPerAccountPerDay":25000,"callsPerKeyPerDay":"2,000 count and preview calls (checkout calls are not counted)","listsPerAccountPerDay":5,"more":"support@meadleybrothers.com"},"name":"Meadley Bros. API","pricing":{"annualCentsPerAddress":25,"annualMembershipCents":34800,"buyOnceMilliCentsPerAddress":349,"buyOnceMinimumCents":34900,"currency":"USD","maximumAddressesPerOrder":25000,"minimumAddresses":1000,"monthlyCentsPerAddress":29,"monthlyMembershipCents":4900,"note":"Counting is free. Records cost exactly what they cost on the site. Volume beyond the daily limits is arranged by email: support@meadleybrothers.com.","sameAsWebsite":true},"terms":"For the key holder's own use. No resale or redistribution of records. https://meadleybrothers.com/terms/","trades":[{"name":"Tree Service","signal":"tree canopy measured close to the house","slug":"tree-services"},{"name":"Forestry Mulching","signal":"brush and tree cover across the lot, acreage","slug":"forestry-mulching"},{"name":"Land Clearing \u0026 Site Prep","signal":"lot size, tree cover, slope","slug":"land-services"},{"name":"Lawn Care","signal":"lot size, few trees at the house","slug":"lawn-care"},{"name":"Landscaping","signal":"lot size, slope near the house, home size and owner tenure","slug":"landscaping"},{"name":"Hardscaping","signal":"sloped or level ground near the house, lot size, pool","slug":"hardscaping"},{"name":"Roofing","signal":"home age, canopy over the roof, owner tenure","slug":"roofing"},{"name":"Pest Control","signal":"tree cover near the house and tree or brush cover across the lot","slug":"pest-control"},{"name":"Pool Service","signal":"pool on record","slug":"pool-services"}],"version":"1"}