{"uid":"cap_U7XktQ1EZ8SFFhHP1A32q","slug":"shovels-api-building-permit-address-search-3ab4fd7c","name":"Shovels API — Building Permit Address Search","description":"Pay-per-call access to the Shovels building-permits search API over x402 and MPP. Search US building permits by date, location, and contractor — no accounts, no subscriptions, pay per request.","url":"https://stable-shovels.dev/api/addresses/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"description":"The term to search for."},"size":{"type":"integer","maximum":100,"minimum":1,"description":"Records to return per page (1–100, default 50). Determines the price — each record returned costs one credit."},"cursor":{"type":"string","description":"Pagination cursor — pass the `next_cursor` from a prior page."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.83","successRate":"0.67","reviews":1,"stars":"4.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LcQ4PMCpyeOmU8hZnitc9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search US building permits by address, date range, and contractor via pay-per-call API with no subscription required","exampleAgentPrompt":"Search Shovels for building permits at 123 Main Street, Austin TX, filed between January 2023 and December 2023 — I want to see what contractors pulled permits there and what work was done.","exampleUseCases":[{"title":"Verify contractor permit history","prompt":"Look up all building permits pulled by Apex Roofing LLC in the Dallas, TX area over the last two years — I want to see how active they are and what types of jobs they typically do before I hire them."},{"title":"Check property renovation activity","prompt":"Search for any building permits filed at 4782 Elm Grove Drive, Denver CO in the past five years — I'm buying this house and want to know if there were any major renovations or additions and whether they were properly permitted."},{"title":"Scout construction activity nearby","prompt":"Find all construction and renovation permits filed within the last six months near 900 Market Street, San Francisco CA — I'm trying to get a sense of how much building activity is happening in that neighborhood right now."}],"resultDescription":"Returns a list of matching US building permit records including permit dates, addresses, contractor names, permit types, and status information based on the search criteria provided.","failureModes":["Payment failure or insufficient USDC balance returns 402 Payment Required","Invalid or unrecognized address returns empty results or 400 Bad Request","Date range outside available data coverage returns empty results","Malformed request body returns 422 Unprocessable Entity","Rate limits or server errors return 429 or 500 status codes"],"whenToPreferThis":"Use this endpoint when you need on-demand, no-subscription access to US building permit data searchable by address, location, date, or contractor — especially useful for one-off lookups or infrequent queries where paying $0.50 per call via x402/USDC is preferable to maintaining a subscription account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":5,"lastUsedAt":"2026-07-15T14:38:59.133Z","lastSuccessfullyRanAt":"2026-07-13T02:48:10.663Z","lastHealthCheckAt":"2026-09-15T12:53:18.329Z","isFirstParty":false}