Firecrawl Alexandria

San José Open Data: building and planning permits (data.sanjoseca.gov)

City of San José building and land-use permits from San José Open Data (data.sanjoseca.gov), the city's CKAN portal, published by Planning, Building and Code Enforcement under Creative Commons CCZero and reloaded daily: Active Building Permits (including those under inspection), Expired Building Permits (back to 1938), the last 30 days of issued building permits, and planning permits issued in the last 30 and 60-180 days. Search building permits by address, ZIP, contractor, type, list, issue-date window, valuation or APN, newest or largest first; read one permit by folder number; rank contractors by permits and valuation for a window; and search planning permits (site development, conditional use, adjustments, tree removals) by address, applicant, type, file number or date. Every response and record carries the licence and a source URL. The lists carry no row update time, so new permits are polled with issued_since; finaled building permits older than 30 days are not published.

Try San José Open Data: building and planning permits (data.sanjoseca.gov) now.

Choose an example or ask your own question.

San José Open Data: building and planning permits (data.sanjoseca.gov)
TRY ASKING
1Request
stringRequired

string

Case-insensitive substring of the contractor as published, to size one firm (Devcon, Sunrun).

string

next_cursor from the previous page; repeat the same filters with it.

string

string

Which published list to read. any (default): Active, Expired and permits issued in the last 30 days, each permit once, in one request. active: issued and not finaled or expired (includes under inspection); under_inspection: active permits with inspections under way; expired; issued_last_30_days: every permit issued in the last 30 days whatever its state, the list to poll for new permits. Finaled permits older than 30 days are not published.

5 credits
Codefollows the fields above
const result = await firecrawl.scrape({
  alexandria: {
    provider: "data-sanjoseca-gov",
    capability: "building-permits/contractor_activity",
    options: {
      contractor: "Devcon",
      issued_since: "2017-01-01",
      issued_until: "2017-12-31",
      status: "expired",
    },
  },
});
2Response example

This is a sample shape. Press Run to see live data from San José Open Data: building and planning permits (data.sanjoseca.gov).

Long values are shortened in this preview. The full response is 5 KB.

{
  "count": 1,
  "dataset": {
    "id": "df4b8461-0c7a-4d16-b85d-ff7f71c5fed5",
    "name": "Expired Building Permits",
    "portal": "data.sanjoseca.gov",
    "updated_at": "2026-10-27T12:00:58Z",
    "url": "https://data.sanjoseca.gov/dataset/expired-building-permits"
  },
  "issued_since": "2017-01-01",
  "issued_until": "2017-12-31",
  "jurisdiction": {
    "county": "Santa Clara",
    "name": "San Jose",
    "state": "CA"
  },
  "license": {
    "attribution": "City of San José Planning, Building and Code Enforcement, via San José Open Data (data.sanjoseca.gov)",
    "name": "Creative Commons CCZero",
    "url": "https://creativecommons.org/publicdomain/zero/1.0/"
  },
  "next_cursor": null,
  "observed_at_ms": 1793149497338,
  "records": [
    {
      "first_issued_date": "2017-01-25",
      "housing_units": 0,
      "last_issued_date": "2017-10-02",
      "license": {
        "attribution": "City of San José Planning, Building and Code Enforcement, via San José Open Data (data.sanjoseca.gov)",
        "name": "Creative Commons CCZero",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/"
      },
      "name": "DEVCON CONSTRUCTION INC",
      "parcels": 3,
      "permits": 8,
      "source_url": "https://data.sanjoseca.gov/api/3/action/datastore_search_sql?sql=SELECT+*+FROM+%28SELECT+t.%22Status%22%2C+t.%22gx_location%22%2C+t.%22ASSESSORS_PARCEL_NUMBER%22%2C+t.%22APPLICANT%22%2C+t.%22CONTRACTOR%22%2C+t.%22FOLDERNUMBER%22%2C+t.%22FOLDERDESC%22%2C+t.%22FOLDERNAME%22%2C+t.%22SUBTYPEDESCRIPTION%22%2C+t.%22WORKDESCRIPTION%22%2C+t.%22PERMITAPPROVALS%22%2C+t.%22ISSUEDATE%22%2C+t.%22FINALDATE%22%2C+t.%22DWELLINGUNITS%22%2C+t.%22PERMITVALUATION%22%2C+t.%22SQUAREFOOTAGE%22%2C+t.%22FOLDERRSN%22%2C+%27expired%27+AS+_list%2C+%27Expired%27+AS+_status%2C+CASE+WHEN+t.%22ISSUEDATE%22+%7E+%27%5E%5B0-9%5D%7B1%2C2%7D%2F%5B0-9%5D%7B1%2C2%7D%2F%5B0-9%5D%7B4%7D%27+THEN+to_date%28t.%22ISSUEDATE%22%2C+%27MM%2FDD%2FYYYY%27%29+END+AS+_issued+FROM+%22df4b8461-0c7a-4d16-b85d-ff7f71c5fed5%22+t%29+AS+p+WHERE+upper%28btrim%28regexp_replace%28p.%22CONTRACTOR%22%2C+%27%28%5Cs%7B2%2C%7D%7C%5Cs%28Mr%7CMrs%7CMs%7CMiss%29%5B.%5D%3F%5Cs%29.*%24%27%2C+%27%27%2C+%27i%27%29%29%29+%3D+upper%28%27DEVCON+CONSTRUCTION+INC%27%29+AND+p._issued+%3E%3D+%272017-01-01%27+AND+p._issued+%3C%3D+%272017-12-31%27+ORDER+BY+p._issued+DESC+NULLS+LAST%2C+p.%22FOLDERNUMBER%22+DESC+LIMIT+100",
      "total_valuation_usd": 190067500
    }
  ],
  "source_url": "https://data.sanjoseca.gov/api/3/action/datastore_search_sql?sql=SELECT+max%28btrim%28regexp_replace%28p.%22CONTRACTOR%22%2C+%27%28%5Cs%7B2%2C%7D%7C%5Cs%28Mr%7CMrs%7CMs%7CMiss%29%5B.%5D%3F%5Cs%29.*%24%27%2C+%27%27%2C+%27i%27%29%29%29+AS+contractor%2C+count%28*%29+AS+permits%2C+sum%28CASE+WHEN+p.%22PERMITVALUATION%22+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28p.%22PERMITVALUATION%22+AS+numeric%29+END%29+AS+valuation%2C+sum%28CASE+WHEN+p.%22DWELLINGUNITS%22+%7E+%27%5E-%3F%5B0-9%5D%2B%24%27+THEN+CAST%28p.%22DWELLINGUNITS%22+AS+integer%29+END%29+AS+housing_units%2C+count%28DISTINCT+p.%22ASSESSORS_PARCEL_NUMBER%22%29+AS+parcels%2C+min%28p._issued%29+AS+first_issued%2C+max%28p._issued%29+AS+last_issued+FROM+%28SELECT+t.%22gx_location%22%2C+t.%22ASSESSORS_PARCEL_NUMBER%22%2C+t.%22CONTRACTOR%22%2C+t.%22FOLDERDESC%22%2C+t.%22SUBTYPEDESCRIPTION%22%2C+t.%22WORKDESCRIPTION%22%2C+t.%22DWELLINGUNITS%22%2C+t.%22PERMITVALUATION%22%2C+t.%22ISSUEDATE%22%2C+t.%22FINALDATE%22%2C+t.%22FOLDERRSN%22%2C+%27expired%27+AS+_list%2C+%27Expired%27+AS+_status%2C+CASE+WHEN+t.%22ISSUEDATE%22+%7E+%27%5E%5B0-9%5D%7B1%2C2%7D%2F%5B0-9%5D%7B1%2C2%7D%2F%5B0-9%5D%7B4%7D%27+THEN+to_date%28t.%22ISSUEDATE%22%2C+%27MM%2FDD%2FYYYY%27%29+END+AS+_issued+FROM+%22df4b8461-0c7a-4d16-b85d-ff7f71c5fed5%22+t%29+AS+p+WHERE+btrim%28regexp_replace%28p.%22CONTRACTOR%22%2C+%27%28%5Cs%7B2%2C%7D%7C%5Cs%28Mr%7CMrs%7CMs%7CMiss%29%5B.%5D%3F%5Cs%29.*%24%27%2C+%27%27%2C+%27i%27%29%29+%3C%3E+%27%27+AND+p._issued+%3E%3D+%272017-01-01%27+AND+p._issued+%3C%3D+%272017-12-31%27+AND+btrim%28regexp_replace%28p.%22CONTRACTOR%22%2C+%27%5Cs%2B%27%2C+%27+%27%2C+%27g%27%29%29+ILIKE+%27%25Devcon%25%27+GROUP+BY+upper%28btrim%28regexp_replace%28p.%22CONTRACTOR%22%2C+%27%28%5Cs%7B2%2C%7D%7C%5Cs%28Mr%7CMrs%7CMs%7CMiss%29%5B.%5D%3F%5Cs%29.*%24%27%2C+%27%27%2C+%27i%27%29%29%29+ORDER+BY+permits+DESC%2C+valuation+DESC+NULLS+LAST%2C+upper%28btrim%28regexp_replace%28p.%22CONTRACTOR%22%2C+%27%28%5Cs%7B2%2C%7D%7C%5Cs%28Mr%7CMrs%… [78 more characters]"
}

Building and planning permits from the City of San José Planning, Building and Code Enforcement, via San José Open Data (data.sanjoseca.gov), CC0 1.0. (https://data.sanjoseca.gov/)

Browse the library