{"uid":"cap_yZXRrIRfEkKoQiKpuOkIr","slug":"shovels-api-building-permit-city-search-d8713f75","name":"Shovels API — Building Permit City 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/cities/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":"Austin","size":10},"response":{"size":15,"items":[{"name":"Austin, TX","state":"TX","geo_id":"a4xysKbZwqg"},{"name":"Austin, Mower, MN","state":"MN","geo_id":"V5R3lNZ9eEs"},{"name":"Austin, Scott, IN","state":"IN","geo_id":"TifxGNRUOME"},{"name":"Sealy, Austin, TX","state":"TX","geo_id":"a2TNLvnh0MA"},{"name":"Austin, Delta, CO","state":"CO","geo_id":"RX942OAAmN0"},{"name":"Kenney, Austin, TX","state":"TX","geo_id":"a10stoICuEg"},{"name":"Wallis, Austin, TX","state":"TX","geo_id":"a4e2c9Z_BnI"},{"name":"Austin, Potter, PA","state":"PA","geo_id":"Zm0hfNY9_OU"},{"name":"Austin, Sevier, UT","state":"UT","geo_id":"bNpyKnP6XlI"},{"name":"Austin, Wilkes, NC","state":"NC","geo_id":"YSAU3ZsPFLw"},{"name":"Austin, Lonoke, AR","state":"AR","geo_id":"Q8Bpc3Dsl5I"},{"name":"Austin, Cayuga, NY","state":"NY","geo_id":"YPaOWR-QT4s"},{"name":"Austin, Lander, NV","state":"NV","geo_id":"XMpFSl_aZnQ"},{"name":"Austin, Tunica, MS","state":"MS","geo_id":"WLIvjAjRhSI"},{"name":"Austin, Barren, KY","state":"KY","geo_id":"USFK22SJQq4"}],"next_cursor":null,"total_count":null}},"exampleRequest":{"q":"Austin","size":10},"tags":["x402"],"displayCostAmount":"0.05","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.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_nc0yrtC4E58mgB_xpgtqn","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 city, date range, and contractor using pay-per-call access via x402/USDC micropayments","exampleAgentPrompt":"Search Shovels for building permits filed in Austin, TX between January 1 and March 31, 2024, filtering for permits associated with the contractor 'Apex Construction'.","exampleUseCases":[{"title":"Track contractor activity by city","prompt":"Find all building permits associated with 'Greenfield Builders' in Denver, CO over the past six months so I can see how active they've been and what types of projects they're working on."},{"title":"Neighborhood construction activity lookup","prompt":"Look up recent building permits filed in Brooklyn, NY between March 1 and June 30, 2024 so I can get a sense of what construction projects are happening in the area right now."},{"title":"Commercial permit research by location","prompt":"Search for commercial building permits filed in Phoenix, AZ during 2023 — I want to see which contractors are doing the most commercial work there and what kinds of projects are being permitted."}],"resultDescription":"A list of matching US building permit records filtered by the requested city, date range, and/or contractor, including permit details such as dates, permit types, contractor names, and location information.","failureModes":["Payment not received or insufficient USDC — 402 Payment Required response","Invalid or unsupported city name — no results or 400 error","Date range too broad or malformed — empty result set or validation error","Unknown contractor name — returns empty results","Service unavailable — 500 or timeout error","x402/MPP payment protocol misconfiguration — payment rejected"],"whenToPreferThis":"Use this endpoint when you need on-demand, no-account access to US building permit data searchable by city, date, and contractor. Ideal for agents needing occasional permit lookups without committing to a subscription, or when paying per-query via USDC micropayments (x402) is preferred over API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-15T14:36:34.829Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:57:15.772Z","isFirstParty":false}