{"uid":"cap_fWI5D_B5ii58LbsLcUC-4","slug":"shovels-api-building-permit-tag-search-49250eb2","name":"Shovels API — Building Permit Tag 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/tags","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"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":"residential construction","size":10},"response":{"size":10,"items":[{"id":"addition","description":"Flag if the permit involves an addition."},{"id":"adu","description":"Flag if the permit involves a new accessory dwelling unit (ADU)."},{"id":"bathroom","description":"Flag if the permit involves a bathroom remodel."},{"id":"battery","description":"Flag if the permit involves a battery installation or upgrade."},{"id":"demolition","description":"Flag if the permit involves demolition."},{"id":"electric_meter","description":"Flag if the permit involves electric meter installation or modification."},{"id":"electrical","description":"Flag if the permit involves electrical work."},{"id":"ev_charger","description":"Flag if the permit involves an EV charger installation."},{"id":"fire_sprinkler","description":"Flag if the permit involves fire sprinkler installation or maintenance."},{"id":"gas","description":"Flag if the permit involves gas line installation or repair."}],"next_cursor":"Z2Fz","total_count":null}},"exampleRequest":{"q":"residential construction","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.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RYaJqb7kVTKxS70wFgKq-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and retrieve tags/categories for US building permits via pay-per-call x402 micropayment, no subscription required","exampleAgentPrompt":"Search the Shovels building permits database for all permit tags filed in Austin, Texas between January 2024 and June 2024 — I want to see what categories of construction work are most common there.","exampleUseCases":[{"title":"Identify contractor specialties by permit history","prompt":"Look up all the building permit tags filed by ABC Construction Company over the last two years — I need to understand what types of projects they typically work on so I can pitch our services to them."},{"title":"Find emerging construction trends in a region","prompt":"Search for building permit categories filed across Miami-Dade County in the past six months — I'm trying to spot which construction types are growing fastest so we can position our materials business accordingly."},{"title":"Validate real estate investment opportunities","prompt":"Pull all permit tags for residential and commercial projects in Denver's downtown district from the last quarter — I want to see development activity before deciding whether to invest in that area."}],"resultDescription":"Returns a list of permit tags/categories matching the search criteria, including tag names and associated permit metadata for US building permits filtered by the specified location, date range, and/or contractor.","failureModes":["Insufficient USDC balance or payment failure via x402 — returns 402 Payment Required","Invalid or missing search parameters — returns 400 Bad Request","No permits found matching the criteria — returns empty results or 404","Rate limiting or server overload — returns 429 or 503","Malformed POST body — returns 400 with validation error"],"whenToPreferThis":"Choose this endpoint when you need one-off or low-volume access to US building permit tag/category data without committing to a subscription. Ideal for agents that need to pay per query using USDC micropayments via x402 protocol. Best for real estate intelligence, construction market research, or contractor activity analysis without upfront account setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:06.201Z","isFirstParty":false}