{"uid":"cap_Rc8IrXtrGo_VaweJsq3LO","slug":"shovels-api-building-permit-search-by-zipcode-dffaada7","name":"Shovels API — Building Permit Search by Zipcode","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/zipcodes/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":{"request":{"q":"90210","size":10},"response":{"size":1,"items":[{"state":"CA","geo_id":"90210"}],"next_cursor":null,"total_count":null}},"exampleRequest":{"q":"90210","size":10},"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/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_fWiXi6Atx28OJ-PQF1jQn","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 zipcode, date range, and contractor via a pay-per-call API using x402 micropayments","exampleAgentPrompt":"Search Shovels for all building permits filed in zipcode 90210 between January 1 2024 and June 30 2024, and filter for permits associated with the contractor 'Acme Construction'.","exampleUseCases":[{"title":"Vet contractor history before hiring","prompt":"Look up all the building permits that ABC Contractors has filed in the last 2 years across California and show me what kind of projects they've been working on."},{"title":"Find new construction activity nearby","prompt":"Search for building permits issued in my zip code 94301 over the past 3 months so I can see what new projects are happening in the neighborhood."},{"title":"Analyze commercial development trends","prompt":"Get all the renovation and commercial permits filed in downtown Denver zip codes 80202 through 80204 for 2023 and 2024 combined, so I can spot industry trends."}],"resultDescription":"Returns a list of US building permit records matching the search criteria, including permit details such as dates, locations, contractor names, permit types, and related metadata for the specified zipcode and filters.","failureModes":["Invalid or non-US zipcode returns empty results or an error","Malformed date range causes a 400 bad request error","Insufficient USDC balance or x402 payment failure prevents the request from completing","No permits found for the given filters returns an empty result set","Rate limiting or server errors return 5xx responses"],"whenToPreferThis":"Use this endpoint when you need to search US building permit data by geographic area (zipcode), date, or contractor without a long-term subscription — ideal for one-off property research, contractor vetting, or construction trend analysis where pay-per-call economics are preferred over a monthly plan.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-15T14:38:57.819Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:36:02.470Z","isFirstParty":false}