Skip to main content
If your search is returning fewer results than expected, the most common causes are limited jurisdiction coverage, filters that are too narrow, recent permits not yet indexed (1–2 month lag), or limited digitization in the local jurisdiction. Most have easy workarounds, and Shovels Online flags the coverage-related ones before you run the search.

Check the Coverage Signals First

When you pick a location and a complete date range, Shovels Online checks how well each filterable field is actually reported in that area for that period — and tells you before you run the search. Disabled filters are left out of the search even when a value is still showing in the panel, so a greyed-out filter never quietly narrows your results. If the area and period contain no permits at all, Shovels Online blocks the search and asks you to change the location or dates instead of returning an empty list. When a banner appears above your results warning that matches may be incomplete, its Review action jumps straight to the filter responsible and highlights it.
These signals are specific to the area and the date range you selected. The same filter can be reliable in one city and unavailable in another, or reliable for recent years and unavailable further back.

1. The Area Has Limited Coverage

Shovels covers approximately 2,000 jurisdictions representing about 85% of the US population. Some cities and counties are not yet in our system, and coverage density varies by region. What to do:
  • Check the Coverage Dashboard to see what’s available in your area
  • Try broadening your search to county or state level
  • Coverage expands monthly — an area with thin data today may improve in coming months

2. Your Filters Are Too Narrow

Shovels Online uses AND logic, so the more filters you apply, the smaller your result set. A search for a specific permit type, in a specific city, within a specific date range can return very few results even in well-covered areas. What to do:
  • Remove one filter at a time and see where results increase
  • Broaden the date range
  • Search at zip code or county level instead of city
  • Try a permit type tag (e.g. solar) instead of a keyword
The search system does not account for typos or terminology variations. Contractors may use different abbreviations (like “SFR” instead of “single family residence”), so try alternatives.

3. Recent Permits May Not Be Indexed Yet

Shovels refreshes data twice a month, and there is a typical 1–2 month lag between when a permit is issued and when it appears in Shovels. Permits filed in the last 4–8 weeks may not be visible yet. What to do:
  • If you’re looking for very recent activity, check back after the next refresh
  • For time-sensitive needs, contact support@shovels.ai and we can check the pipeline

4. The Jurisdiction Uses Limited Digitization

Even within covered jurisdictions, some local governments have incomplete or inconsistently formatted permit records. This can result in sparse data for specific cities or permit types. What to do:
  • Email support@shovels.ai with the specific jurisdiction — we can investigate and flag it for improvement

Still Not Finding What You Need?

Email support@shovels.ai with:
  • The specific area or jurisdiction you’re searching
  • The permit type or contractor you’re looking for
  • What results you expected vs. what you got
We’ll investigate and let you know what’s happening.