--- type: "firecrawl-provider" description: "City of San Antonio, Texas building permits from the city's CKAN open data portal (data.sanantonio.gov): the Building Permits dataset of the Development Services Department (Land and Building Development), licensed Creative Commons Attribution (CC BY). It holds every issued building, trade (mechanical, electrical, plumbing, irrigation), repair, roof, solar, sign, tree, demolition and site permit from July 2020 to the city's latest load, over 430,000 permits. Search permits by street address, ZIP, primary contact (contractor, builder or expediter), permit or work type, issue or application date window and minimum declared valuation, newest issued, newest submitted or largest first; read one permit by number with every published column; and rank primary contacts by permits and valuation for an issue window. Garage sale permits are left out. Every response and record carries the CC BY licence with attribution to the City of San Antonio and a source URL. The dataset has no row update time, so new permits are polled with issued_since." use_when: "City of San Antonio, Texas building permits from the city's CKAN open data portal (data.sanantonio.gov): the Building Permits dataset of the Development Services Department (Land and Building Development), licensed Creative Commons Attribution (CC BY). It holds every issued building, trade (mechanical, electrical, plumbing, irrigation), repair, roof, solar, sign, tree, demolition and site permit from July 2020 to the city's latest load, over 430,000 permits. Search permits by street address, ZIP, primary contact (contractor, builder or expediter), permit or work type, issue or application date window and minimum declared valuation, newest issued, newest submitted or largest first; read one permit by number with every published column; and rank primary contacts by permits and valuation for an issue window. Garage sale permits are left out. Every response and record carries the CC BY licence with attribution to the City of San Antonio and a source URL. The dataset has no row update time, so new permits are polled with issued_since." categories: "Real estate" capabilities: 3 credits_per_call: 5 --- # City of San Antonio Open Data: building permits (data.sanantonio.gov) on Firecrawl Alexandria City of San Antonio, Texas building permits from the city's CKAN open data portal (data.sanantonio.gov): the Building Permits dataset of the Development Services Department (Land and Building Development), licensed Creative Commons Attribution (CC BY). It holds every issued building, trade (mechanical, electrical, plumbing, irrigation), repair, roof, solar, sign, tree, demolition and site permit from July 2020 to the city's latest load, over 430,000 permits. Search permits by street address, ZIP, primary contact (contractor, builder or expediter), permit or work type, issue or application date window and minimum declared valuation, newest issued, newest submitted or largest first; read one permit by number with every published column; and rank primary contacts by permits and valuation for an issue window. Garage sale permits are left out. Every response and record carries the CC BY licence with attribution to the City of San Antonio and a source URL. The dataset has no row update time, so new permits are polled with issued_since. - Categories: Real estate - Category index: [Real estate category](https://firecrawl.dev/alexandria/agents/categories/real-estate) - Provider key: `data-sanantonio-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/data-sanantonio-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/data-sanantonio-gov/openapi.json) ## Capabilities - [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/data-sanantonio-gov/building-permits/contractor_activity): Rank San Antonio permit primary contacts (the contractor, builder or permit expediter the city lists on each permit) by permits issued in an issue-date window, or by total declared valuation, from one grouped query over the Building Permits dataset. Optional contact substring, permit or work type and ZIP. Each permit counts once however many trade rows it has. Names group case-insensitively; spelling variants of one firm stay separate rows. Each row has permits, total valuation, first and last issue days, a source_url listing those permits, and the CC BY licence crediting the City of San Antonio. - [Get permit](https://firecrawl.dev/alexandria/agents/providers/data-sanantonio-gov/building-permits/get_permit): One City of San Antonio issued building permit by number (COM-RML-PMT26-40000663): the shared permit fields with every permit type of a combination permit, the primary contact, council district, source_url, the CC BY licence crediting the City of San Antonio, and raw, the permit's first datastore row with every published column (location note, state-plane coordinates, neighbourhood conservation and historic district). Looks in the 2025-to-date file, then the 2020-2024 file. An unknown number, a permit not yet issued or one issued before July 2020 is not_found; garage sale permits (BLDG-GS-) are refused as invalid input. - [Search permits](https://firecrawl.dev/alexandria/agents/providers/data-sanantonio-gov/building-permits/search_permits): Search City of San Antonio issued building permits (data.sanantonio.gov Building Permits, July 2020 to the latest load; garage sale permits left out) by street address, ZIP, primary contact (contractor, builder or expediter), permit or work type, issue or application date window and minimum declared valuation; newest issued first, newest submitted first, or largest valuation first. One record per permit number: a combination permit's building and trade rows are merged and its types listed. Each record has the shared permit fields (number, types, work type, project name, submitted and issued days, address, ZIP, coordinates, valuation, area, primary contact), the council district, source_url and the CC BY licence crediting the City of San Antonio. An empty page is a valid result. ## 1. Choose this provider when City of San Antonio, Texas building permits from the city's CKAN open data portal (data.sanantonio.gov): the Building Permits dataset of the Development Services Department (Land and Building Development), licensed Creative Commons Attribution (CC BY). It holds every issued building, trade (mechanical, electrical, plumbing, irrigation), repair, roof, solar, sign, tree, demolition and site permit from July 2020 to the city's latest load, over 430,000 permits. Search permits by street address, ZIP, primary contact (contractor, builder or expediter), permit or work type, issue or application date window and minimum declared valuation, newest issued, newest submitted or largest first; read one permit by number with every published column; and rank primary contacts by permits and valuation for an issue window. Garage sale permits are left out. Every response and record carries the CC BY licence with attribution to the City of San Antonio and a source URL. The dataset has no row update time, so new permits are polled with issued_since. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "data-sanantonio-gov", "capability": "building-permits/contractor_activity", "options": { "contractor": "Lennar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } } ``` ## 3. Add provider options Use only the options needed for the task: - `contractor` (string): Case-insensitive substring of the primary contact, to find one contractor's groups. Example: `` - `cursor` (string): next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. Example: `` - `issued_since` (string, required): Count permits issued on or after this day, YYYY-MM-DD (data starts 2020-07-20). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `issued_until` (string): Count permits issued on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `limit` (number): Contacts per page. Example: `25` - `permit_type` (string): Case-insensitive substring of any of the permit's types or its work type (solar, roof, res new building, comm remodel). Example: `` - `sort` (string): permits_desc: most permits first; valuation_desc: largest total declared valuation first. Example: `permits_desc` - `zip` (string): 5-digit ZIP code (78215). Pattern: ^[0-9]{5}$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "data-sanantonio-gov", capability: "building-permits/contractor_activity", options: { contractor: "Lennar", issued_since: "2025-01-01", issued_until: "2025-12-31", limit: 5, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "data-sanantonio-gov", "capability": "building-permits/contractor_activity", "options": { "contractor": "Lennar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "data-sanantonio-gov", "capability": "building-permits/contractor_activity", "options": { "contractor": "Lennar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } } }' ``` ### CLI ```sh firecrawl scrape 'data-sanantonio-gov/building-permits/contractor_activity' \ --options '{"contractor":"Lennar","issued_since":"2025-01-01","issued_until":"2025-12-31","limit":5}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "data-sanantonio-gov", "capability": "building-permits/contractor_activity", "options": { "contractor": "Lennar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "data-sanantonio-gov", "capability": "building-permits/contractor_activity", "options": { "contractor": "Lennar", "issued_since": "2025-01-01", "issued_until": "2025-12-31", "limit": 5 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "count": 2, "dataset": { "id": "building-permits", "name": "Building Permits", "portal": "data.sanantonio.gov", "updated_at": "2026-10-25T04:01:50Z", "url": "https://data.sanantonio.gov/dataset/building-permits" }, "issued_since": "2025-01-01", "issued_until": "2025-12-31", "jurisdiction": { "county": "Bexar", "name": "San Antonio", "state": "TX" }, "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "next_cursor": null, "observed_at_ms": 1793149446554, "records": [ { "first_issued_date": "2025-01-02", "last_issued_date": "2025-12-24", "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "name": "LENNAR HOMES", "permits": 1209, "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search_sql?sql=SELECT+permit%2C+min%28src%29+AS+src%2C+string_agg%28DISTINCT+ptype%2C+%27%3B+%27%29+AS+permit_types%2C+max%28pname%29+AS+pname%2C+max%28wtype%29+AS+wtype%2C+max%28addr%29+AS+addr%2C+max%28x%29+AS+x%2C+max%28y%29+AS+y%2C+min%28submitted%29+AS+submitted%2C+max%28issued%29+AS+issued%2C+sum%28DISTINCT+CASE+WHEN+val+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28val+AS+numeric%29+END%29+AS+valuation%2C+sum%28DISTINCT+CASE+WHEN+area+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28area+AS+numeric%29+END%29+AS+area%2C+max%28contact%29+AS+contact%2C+max%28cd%29+AS+cd+FROM+%28SELECT+1+AS+src%2C+%22PERMIT+%23%22+AS+permit%2C+%22PERMIT+TYPE%22+AS+ptype%2C+%22PROJECT+NAME%22+AS+pname%2C+%22WORK+TYPE%22+AS+wtype%2C+%22ADDRESS%22+AS+addr%2C+%22X_COORD%22+AS+x%2C+%22Y_COORD%22+AS+y%2C+left%28CAST%28%22DATE+SUBMITTED%22+AS+text%29%2C+10%29+AS+submitted%2C+left%28CAST%28%22DATE+ISSUED%22+AS+text%29%2C+10%29+AS+issued%2C+%22DECLARED+VALUATION%22+AS+val%2C+%22AREA+%28SF%29%22+AS+area%2C+%22PRIMARY+CONTACT%22+AS+contact%2C+%22CD%22+AS+cd+FROM+%22c21106f9-3ef5-4f3a-8604-f992b4db7512%22%29+p+WHERE+ptype+%3C%3E+%27Garage+Sale%27+AND+upper%28contact%29+%3D+upper%28%27LENNAR+HOMES%27%29+AND+issued+%3E%3D+%272025-01-01%27+AND+issued+%3C%3D+%272025-12-31%27+GROUP+BY+permit+ORDER+BY+issued+DESC%2C+permit+DESC+LIMIT+100", "total_valuation_usd": null }, { "first_issued_date": "2025-01-02", "last_issued_date": "2025-12-19", "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "name": "COURTNEY CHAPPELL, LENNAR HOMES", "permits": 53, "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search_sql?sql=SELECT+permit%2C+min%28src%29+AS+src%2C+string_agg%28DISTINCT+ptype%2C+%27%3B+%27%29+AS+permit_types%2C+max%28pname%29+AS+pname%2C+max%28wtype%29+AS+wtype%2C+max%28addr%29+AS+addr%2C+max%28x%29+AS+x%2C+max%28y%29+AS+y%2C+min%28submitted%29+AS+submitted%2C+max%28issued%29+AS+issued%2C+sum%28DISTINCT+CASE+WHEN+val+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28val+AS+numeric%29+END%29+AS+valuation%2C+sum%28DISTINCT+CASE+WHEN+area+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28area+AS+numeric%29+END%29+AS+area%2C+max%28contact%29+AS+contact%2C+max%28cd%29+AS+cd+FROM+%28SELECT+1+AS+src%2C+%22PERMIT+%23%22+AS+permit%2C+%22PERMIT+TYPE%22+AS+ptype%2C+%22PROJECT+NAME%22+AS+pname%2C+%22WORK+TYPE%22+AS+wtype%2C+%22ADDRESS%22+AS+addr%2C+%22X_COORD%22+AS+x%2C+%22Y_COORD%22+AS+y%2C+left%28CAST%28%22DATE+SUBMITTED%22+AS+text%29%2C+10%29+AS+submitted%2C+left%28CAST%28%22DATE+ISSUED%22+AS+text%29%2C+10%29+AS+issued%2C+%22DECLARED+VALUATION%22+AS+val%2C+%22AREA+%28SF%29%22+AS+area%2C+%22PRIMARY+CONTACT%22+AS+contact%2C+%22CD%22+AS+cd+FROM+%22c21106f9-3ef5-4f3a-8604-f992b4db7512%22%29+p+WHERE+ptype+%3C%3E+%27Garage+Sale%27+AND+upper%28contact%29+%3D+upper%28%27COURTNEY+CHAPPELL%2C+LENNAR+HOMES%27%29+AND+issued+%3E%3D+%272025-01-01%27+AND+issued+%3C%3D+%272025-12-31%27+GROUP+BY+permit+ORDER+BY+issued+DESC%2C+permit+DESC+LIMIT+100", "total_valuation_usd": null } ], "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search_sql?sql=SELECT+max%28contact%29+AS+contact%2C+count%28*%29+AS+permits%2C+sum%28valuation%29+AS+valuation%2C+min%28issued%29+AS+first_issued%2C+max%28issued%29+AS+last_issued+FROM+%28SELECT+permit%2C+max%28contact%29+AS+contact%2C+max%28issued%29+AS+issued%2C+sum%28DISTINCT+CASE+WHEN+val+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28val+AS+numeric%29+END%29+AS+valuation+FROM+%28SELECT+1+AS+src%2C+%22PERMIT+%23%22+AS+permit%2C+%22PERMIT+TYPE%22+AS+ptype%2C+%22PROJECT+NAME%22+AS+pname%2C+%22WORK+TYPE%22+AS+wtype%2C+%22ADDRESS%22+AS+addr%2C+%22X_COORD%22+AS+x%2C+%22Y_COORD%22+AS+y%2C+left%28CAST%28%22DATE+SUBMITTED%22+AS+text%29%2C+10%29+AS+submitted%2C+left%28CAST%28%22DATE+ISSUED%22+AS+text%29%2C+10%29+AS+issued%2C+%22DECLARED+VALUATION%22+AS+val%2C+%22AREA+%28SF%29%22+AS+area%2C+%22PRIMARY+CONTACT%22+AS+contact%2C+%22CD%22+AS+cd+FROM+%22c21106f9-3ef5-4f3a-8604-f992b4db7512%22%29+p+WHERE+ptype+%3C%3E+%27Garage+Sale%27+AND+contact+IS+NOT+NULL+AND+contact+%3C%3E+%27NULL%27+AND+issued+%3E%3D+%272025-01-01%27+AND+issued+%3C%3D+%272025-12-31%27+AND+contact+ILIKE+%27%25Lennar%25%27+GROUP+BY+permit%29+g+GROUP+BY+upper%28contact%29+ORDER+BY+permits+DESC%2C+valuation+DESC+NULLS+LAST%2C+upper%28contact%29+LIMIT+5" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Contractor activity - Capability: `building-permits/contractor_activity` - Description: Rank San Antonio permit primary contacts (the contractor, builder or permit expediter the city lists on each permit) by permits issued in an issue-date window, or by total declared valuation, from one grouped query over the Building Permits dataset. Optional contact substring, permit or work type and ZIP. Each permit counts once however many trade rows it has. Names group case-insensitively; spelling variants of one firm stay separate rows. Each row has permits, total valuation, first and last issue days, a source_url listing those permits, and the CC BY licence crediting the City of San Antonio. - Instructions: Use to find the most active contractors or home builders in San Antonio, a ZIP or a trade (solar, roof, res new building) for a period, or to size one contractor's activity; then search_permits with contractor for the permits themselves. - Cost: 5 credits per call - Capability file: [Contractor activity](https://firecrawl.dev/alexandria/agents/providers/data-sanantonio-gov/building-permits/contractor_activity) Accepted options: - `contractor` (string): Case-insensitive substring of the primary contact, to find one contractor's groups. Example: `` - `cursor` (string): next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. Example: `` - `issued_since` (string, required): Count permits issued on or after this day, YYYY-MM-DD (data starts 2020-07-20). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `issued_until` (string): Count permits issued on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `limit` (number): Contacts per page. Example: `25` - `permit_type` (string): Case-insensitive substring of any of the permit's types or its work type (solar, roof, res new building, comm remodel). Example: `` - `sort` (string): permits_desc: most permits first; valuation_desc: largest total declared valuation first. Example: `permits_desc` - `zip` (string): 5-digit ZIP code (78215). Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "count": 2, "dataset": { "id": "building-permits", "name": "Building Permits", "portal": "data.sanantonio.gov", "updated_at": "2026-10-25T04:01:50Z", "url": "https://data.sanantonio.gov/dataset/building-permits" }, "issued_since": "2025-01-01", "issued_until": "2025-12-31", "jurisdiction": { "county": "Bexar", "name": "San Antonio", "state": "TX" }, "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "next_cursor": null, "observed_at_ms": 1793149446554, "records": [ { "first_issued_date": "2025-01-02", "last_issued_date": "2025-12-24", "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "name": "LENNAR HOMES", "permits": 1209, "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search_sql?sql=SELECT+permit%2C+min%28src%29+AS+src%2C+string_agg%28DISTINCT+ptype%2C+%27%3B+%27%29+AS+permit_types%2C+max%28pname%29+AS+pname%2C+max%28wtype%29+AS+wtype%2C+max%28addr%29+AS+addr%2C+max%28x%29+AS+x%2C+max%28y%29+AS+y%2C+min%28submitted%29+AS+submitted%2C+max%28issued%29+AS+issued%2C+sum%28DISTINCT+CASE+WHEN+val+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28val+AS+numeric%29+END%29+AS+valuation%2C+sum%28DISTINCT+CASE+WHEN+area+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28area+AS+numeric%29+END%29+AS+area%2C+max%28contact%29+AS+contact%2C+max%28cd%29+AS+cd+FROM+%28SELECT+1+AS+src%2C+%22PERMIT+%23%22+AS+permit%2C+%22PERMIT+TYPE%22+AS+ptype%2C+%22PROJECT+NAME%22+AS+pname%2C+%22WORK+TYPE%22+AS+wtype%2C+%22ADDRESS%22+AS+addr%2C+%22X_COORD%22+AS+x%2C+%22Y_COORD%22+AS+y%2C+left%28CAST%28%22DATE+SUBMITTED%22+AS+text%29%2C+10%29+AS+submitted%2C+left%28CAST%28%22DATE+ISSUED%22+AS+text%29%2C+10%29+AS+issued%2C+%22DECLARED+VALUATION%22+AS+val%2C+%22AREA+%28SF%29%22+AS+area%2C+%22PRIMARY+CONTACT%22+AS+contact%2C+%22CD%22+AS+cd+FROM+%22c21106f9-3ef5-4f3a-8604-f992b4db7512%22%29+p+WHERE+ptype+%3C%3E+%27Garage+Sale%27+AND+upper%28contact%29+%3D+upper%28%27LENNAR+HOMES%27%29+AND+issued+%3E%3D+%272025-01-01%27+AND+issued+%3C%3D+%272025-12-31%27+GROUP+BY+permit+ORDER+BY+issued+DESC%2C+permit+DESC+LIMIT+100", "total_valuation_usd": null }, { "first_issued_date": "2025-01-02", "last_issued_date": "2025-12-19", "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "name": "COURTNEY CHAPPELL, LENNAR HOMES", "permits": 53, "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search_sql?sql=SELECT+permit%2C+min%28src%29+AS+src%2C+string_agg%28DISTINCT+ptype%2C+%27%3B+%27%29+AS+permit_types%2C+max%28pname%29+AS+pname%2C+max%28wtype%29+AS+wtype%2C+max%28addr%29+AS+addr%2C+max%28x%29+AS+x%2C+max%28y%29+AS+y%2C+min%28submitted%29+AS+submitted%2C+max%28issued%29+AS+issued%2C+sum%28DISTINCT+CASE+WHEN+val+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28val+AS+numeric%29+END%29+AS+valuation%2C+sum%28DISTINCT+CASE+WHEN+area+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28area+AS+numeric%29+END%29+AS+area%2C+max%28contact%29+AS+contact%2C+max%28cd%29+AS+cd+FROM+%28SELECT+1+AS+src%2C+%22PERMIT+%23%22+AS+permit%2C+%22PERMIT+TYPE%22+AS+ptype%2C+%22PROJECT+NAME%22+AS+pname%2C+%22WORK+TYPE%22+AS+wtype%2C+%22ADDRESS%22+AS+addr%2C+%22X_COORD%22+AS+x%2C+%22Y_COORD%22+AS+y%2C+left%28CAST%28%22DATE+SUBMITTED%22+AS+text%29%2C+10%29+AS+submitted%2C+left%28CAST%28%22DATE+ISSUED%22+AS+text%29%2C+10%29+AS+issued%2C+%22DECLARED+VALUATION%22+AS+val%2C+%22AREA+%28SF%29%22+AS+area%2C+%22PRIMARY+CONTACT%22+AS+contact%2C+%22CD%22+AS+cd+FROM+%22c21106f9-3ef5-4f3a-8604-f992b4db7512%22%29+p+WHERE+ptype+%3C%3E+%27Garage+Sale%27+AND+upper%28contact%29+%3D+upper%28%27COURTNEY+CHAPPELL%2C+LENNAR+HOMES%27%29+AND+issued+%3E%3D+%272025-01-01%27+AND+issued+%3C%3D+%272025-12-31%27+GROUP+BY+permit+ORDER+BY+issued+DESC%2C+permit+DESC+LIMIT+100", "total_valuation_usd": null } ], "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search_sql?sql=SELECT+max%28contact%29+AS+contact%2C+count%28*%29+AS+permits%2C+sum%28valuation%29+AS+valuation%2C+min%28issued%29+AS+first_issued%2C+max%28issued%29+AS+last_issued+FROM+%28SELECT+permit%2C+max%28contact%29+AS+contact%2C+max%28issued%29+AS+issued%2C+sum%28DISTINCT+CASE+WHEN+val+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28val+AS+numeric%29+END%29+AS+valuation+FROM+%28SELECT+1+AS+src%2C+%22PERMIT+%23%22+AS+permit%2C+%22PERMIT+TYPE%22+AS+ptype%2C+%22PROJECT+NAME%22+AS+pname%2C+%22WORK+TYPE%22+AS+wtype%2C+%22ADDRESS%22+AS+addr%2C+%22X_COORD%22+AS+x%2C+%22Y_COORD%22+AS+y%2C+left%28CAST%28%22DATE+SUBMITTED%22+AS+text%29%2C+10%29+AS+submitted%2C+left%28CAST%28%22DATE+ISSUED%22+AS+text%29%2C+10%29+AS+issued%2C+%22DECLARED+VALUATION%22+AS+val%2C+%22AREA+%28SF%29%22+AS+area%2C+%22PRIMARY+CONTACT%22+AS+contact%2C+%22CD%22+AS+cd+FROM+%22c21106f9-3ef5-4f3a-8604-f992b4db7512%22%29+p+WHERE+ptype+%3C%3E+%27Garage+Sale%27+AND+contact+IS+NOT+NULL+AND+contact+%3C%3E+%27NULL%27+AND+issued+%3E%3D+%272025-01-01%27+AND+issued+%3C%3D+%272025-12-31%27+AND+contact+ILIKE+%27%25Lennar%25%27+GROUP+BY+permit%29+g+GROUP+BY+upper%28contact%29+ORDER+BY+permits+DESC%2C+valuation+DESC+NULLS+LAST%2C+upper%28contact%29+LIMIT+5" } ``` ### Get permit - Capability: `building-permits/get_permit` - Description: One City of San Antonio issued building permit by number (COM-RML-PMT26-40000663): the shared permit fields with every permit type of a combination permit, the primary contact, council district, source_url, the CC BY licence crediting the City of San Antonio, and raw, the permit's first datastore row with every published column (location note, state-plane coordinates, neighbourhood conservation and historic district). Looks in the 2025-to-date file, then the 2020-2024 file. An unknown number, a permit not yet issued or one issued before July 2020 is not_found; garage sale permits (BLDG-GS-) are refused as invalid input. - Instructions: After search_permits, or when you have a San Antonio permit number, to see every published column. - Cost: 5 credits per call - Capability file: [Get permit](https://firecrawl.dev/alexandria/agents/providers/data-sanantonio-gov/building-permits/get_permit) Accepted options: - `permit_number` (string, required): Accela permit number, letter and digit groups joined by hyphens (COM-RML-PMT26-40000663); case-insensitive. Pattern: ^[A-Za-z0-9]+(-[A-Za-z0-9]+)+$. Example: `` Response schema example: ```json { "address": "717 N ALAMO ST", "applied_date": "2026-01-01", "city": "San Antonio", "completed_date": null, "contractors": [ { "company": null, "license_number": null, "name": "Fernando DeLeon", "phone": null, "role": "primary_contact" } ], "council_district": "1", "dataset": { "id": "building-permits", "name": "Building Permits", "portal": "data.sanantonio.gov", "updated_at": "2026-10-25T04:01:50Z", "url": "https://data.sanantonio.gov/dataset/building-permits" }, "description": "Building No: 1; Unit No: N/A", "expires_date": null, "housing_units": null, "issued_date": "2026-10-22", "jurisdiction": { "county": "Bexar", "name": "San Antonio", "state": "TX" }, "latitude": 29.431705, "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "longitude": -98.482284, "observed_at_ms": 1793149443205, "parcel_id": null, "permit_class": null, "permit_number": "COM-RML-PMT26-40000663", "permit_type": "Comm Remodel Permit; Electrical General Permit; Mechanical Permit; Plumbing General Permit; Plumbing Irrigation Permit; Plumbing Sewer Permit", "raw": { "ADDRESS": "717 N ALAMO ST, City of San Antonio, TX 78215", "AREA (SF)": null, "CD": "1", "DATE ISSUED": "2026-10-22", "DATE SUBMITTED": "2026-01-01", "DECLARED VALUATION": null, "HD": null, "LOCATION": null, "NCD": null, "PERMIT #": "COM-RML-PMT26-40000663", "PERMIT TYPE": "Comm Remodel Permit", "PRIMARY CONTACT": "Fernando DeLeon", "PROJECT NAME": "Building No: 1; Unit No: N/A", "WORK TYPE": "Existing", "X_COORD": "-98.482284", "Y_COORD": "29.431705" }, "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search?resource_id=c21106f9-3ef5-4f3a-8604-f992b4db7512&filters=%7B%22PERMIT+%23%22%3A%22COM-RML-PMT26-40000663%22%7D&sort=_id", "square_feet": null, "state": "TX", "status": null, "valuation_usd": null, "work_class": "Existing", "zip": "78215" } ``` ### Search permits - Capability: `building-permits/search_permits` - Description: Search City of San Antonio issued building permits (data.sanantonio.gov Building Permits, July 2020 to the latest load; garage sale permits left out) by street address, ZIP, primary contact (contractor, builder or expediter), permit or work type, issue or application date window and minimum declared valuation; newest issued first, newest submitted first, or largest valuation first. One record per permit number: a combination permit's building and trade rows are merged and its types listed. Each record has the shared permit fields (number, types, work type, project name, submitted and issued days, address, ZIP, coordinates, valuation, area, primary contact), the council district, source_url and the CC BY licence crediting the City of San Antonio. An empty page is a valid result. - Instructions: Use for permits at a San Antonio address or ZIP, one contractor's or builder's permits, large projects, or new permits since a date: pass issued_since (the last day you checked); the dataset has no row update time. Then get_permit for every published column, or contractor_activity to rank contacts. - Cost: 5 credits per call - Capability file: [Search permits](https://firecrawl.dev/alexandria/agents/providers/data-sanantonio-gov/building-permits/search_permits) Accepted options: - `address` (string): Street line, case-insensitive substring (717 N Alamo St, 315 Tahoe Avenue). Text after a comma is ignored; North/South/East/West after the house number and a trailing Street, Avenue, Drive, Road, Boulevard, Lane and similar become the city's abbreviations (N, ST, AVE, DR, RD, BLVD, LN). Also matches the project name of permits published without an address. Example: `
` - `applied_since` (string): Only permits first submitted on or after this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `applied_until` (string): Only permits first submitted on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `contractor` (string): Case-insensitive substring of the primary contact (Lennar, Will Fix It, Sunrun). Example: `` - `cursor` (string): next_cursor from the previous page; repeat the same filters with it. Pattern: ^[0-9]+$. Example: `` - `issued_since` (string): Only permits issued on or after this day, YYYY-MM-DD (data starts 2020-07-20). Pass the last day you checked to poll for new permits. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `issued_until` (string): Only permits issued on or before this day, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `limit` (number): Permits per page. Example: `25` - `min_valuation` (number): Only permits whose declared valuation is at least this many USD (excludes permits without one). Example: `10` - `permit_type` (string): Case-insensitive substring of any of the permit's types or of its work type: new building, res new building, comm remodel, roof, solar, demolition, electrical, sign, tree. A combination permit matches through any of its trade permits. Example: `` - `sort` (string): issued_desc: newest issued first; applied_desc: newest submitted first; valuation_desc: largest declared valuation first. Example: `issued_desc` - `zip` (string): 5-digit ZIP code (78215). Pattern: ^[0-9]{5}$. Example: `` Response schema example: ```json { "count": 4, "dataset": { "id": "building-permits", "name": "Building Permits", "portal": "data.sanantonio.gov", "updated_at": "2026-10-25T04:01:50Z", "url": "https://data.sanantonio.gov/dataset/building-permits" }, "jurisdiction": { "county": "Bexar", "name": "San Antonio", "state": "TX" }, "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "next_cursor": null, "observed_at_ms": 1793149437749, "records": [ { "address": "717 N ALAMO ST", "applied_date": "2026-01-01", "city": "San Antonio", "completed_date": null, "contractors": [ { "company": null, "license_number": null, "name": "Fernando DeLeon", "phone": null, "role": "primary_contact" } ], "council_district": "1", "description": "Building No: 1; Unit No: N/A", "expires_date": null, "housing_units": null, "issued_date": "2026-10-22", "latitude": 29.431705, "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "longitude": -98.482284, "parcel_id": null, "permit_class": null, "permit_number": "COM-RML-PMT26-40000663", "permit_type": "Comm Remodel Permit; Electrical General Permit; Mechanical Permit; Plumbing General Permit; Plumbing Irrigation Permit; Plumbing Sewer Permit", "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search?resource_id=c21106f9-3ef5-4f3a-8604-f992b4db7512&filters=%7B%22PERMIT+%23%22%3A%22COM-RML-PMT26-40000663%22%7D&sort=_id", "square_feet": null, "state": "TX", "status": null, "valuation_usd": null, "work_class": "Existing", "zip": "78215" }, { "address": "717 N ALAMO ST", "applied_date": "2026-03-13", "city": "San Antonio", "completed_date": null, "contractors": [ { "company": null, "license_number": null, "name": "John Thompson", "phone": null, "role": "primary_contact" } ], "council_district": "1", "description": "717 N ALAMO ST", "expires_date": null, "housing_units": null, "issued_date": "2026-03-25", "latitude": 29.431802, "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "longitude": -98.482386, "parcel_id": null, "permit_class": null, "permit_number": "SIG-OPS-PMT26-21500475", "permit_type": "On Premise Sign", "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search?resource_id=c21106f9-3ef5-4f3a-8604-f992b4db7512&filters=%7B%22PERMIT+%23%22%3A%22SIG-OPS-PMT26-21500475%22%7D&sort=_id", "square_feet": null, "state": "TX", "status": null, "valuation_usd": null, "work_class": null, "zip": "78215" }, { "address": "717 N ALAMO ST", "applied_date": "2022-09-07", "city": "San Antonio", "completed_date": null, "contractors": [ { "company": null, "license_number": null, "name": "Jerry Lee Gonzales", "phone": null, "role": "primary_contact" } ], "council_district": "1", "description": "Building No: 1; Unit No: 1", "expires_date": null, "housing_units": null, "issued_date": "2023-05-26", "latitude": 29.431802, "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "longitude": -98.482386, "parcel_id": null, "permit_class": null, "permit_number": "COM-RML-PMT23-40000418", "permit_type": "Comm Remodel Permit; Electrical General Permit; Electrical TOPS Permit; Mechanical Permit; Plumbing Gas Permit; Plumbing General Permit; Plumbing Irrigation Permit", "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search?resource_id=c22b1ef2-dcf8-4d77-be1a-ee3638092aab&filters=%7B%22PERMIT+%23%22%3A%22COM-RML-PMT23-40000418%22%7D&sort=_id", "square_feet": null, "state": "TX", "status": null, "valuation_usd": null, "work_class": "Existing", "zip": "78215" }, { "address": "717 N ALAMO ST", "applied_date": "2022-08-31", "city": "San Antonio", "completed_date": null, "contractors": [ { "company": null, "license_number": null, "name": "jose castillo, WIRED-UP ELECTRIC", "phone": null, "role": "primary_contact" } ], "council_district": "1", "description": "717 N ALAMO ST", "expires_date": null, "housing_units": null, "issued_date": "2022-09-30", "latitude": 29.431802, "license": { "attribution": "City of San Antonio, Development Services Department: Building Permits, City of San Antonio Open Data Portal (data.sanantonio.gov)", "name": "Creative Commons Attribution (CC BY)", "url": "https://opendefinition.org/licenses/cc-by/" }, "longitude": -98.482386, "parcel_id": null, "permit_class": null, "permit_number": "SIG-OPS-PMT22-21501494", "permit_type": "On Premise Sign", "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search?resource_id=c22b1ef2-dcf8-4d77-be1a-ee3638092aab&filters=%7B%22PERMIT+%23%22%3A%22SIG-OPS-PMT22-21501494%22%7D&sort=_id", "square_feet": null, "state": "TX", "status": null, "valuation_usd": null, "work_class": null, "zip": "78215" } ], "source_url": "https://data.sanantonio.gov/api/3/action/datastore_search_sql?sql=SELECT+permit%2C+min%28src%29+AS+src%2C+string_agg%28DISTINCT+ptype%2C+%27%3B+%27%29+AS+permit_types%2C+max%28pname%29+AS+pname%2C+max%28wtype%29+AS+wtype%2C+max%28addr%29+AS+addr%2C+max%28x%29+AS+x%2C+max%28y%29+AS+y%2C+min%28submitted%29+AS+submitted%2C+max%28issued%29+AS+issued%2C+sum%28DISTINCT+CASE+WHEN+val+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28val+AS+numeric%29+END%29+AS+valuation%2C+sum%28DISTINCT+CASE+WHEN+area+%7E+%27%5E%5B0-9%5D%2B%28%5B.%5D%5B0-9%5D%2B%29%3F%24%27+THEN+CAST%28area+AS+numeric%29+END%29+AS+area%2C+max%28contact%29+AS+contact%2C+max%28cd%29+AS+cd+FROM+%28SELECT+1+AS+src%2C+%22PERMIT+%23%22+AS+permit%2C+%22PERMIT+TYPE%22+AS+ptype%2C+%22PROJECT+NAME%22+AS+pname%2C+%22WORK+TYPE%22+AS+wtype%2C+%22ADDRESS%22+AS+addr%2C+%22X_COORD%22+AS+x%2C+%22Y_COORD%22+AS+y%2C+left%28CAST%28%22DATE+SUBMITTED%22+AS+text%29%2C+10%29+AS+submitted%2C+left%28CAST%28%22DATE+ISSUED%22+AS+text%29%2C+10%29+AS+issued%2C+%22DECLARED+VALUATION%22+AS+val%2C+%22AREA+%28SF%29%22+AS+area%2C+%22PRIMARY+CONTACT%22+AS+contact%2C+%22CD%22+AS+cd+FROM+%22c21106f9-3ef5-4f3a-8604-f992b4db7512%22+UNION+ALL+SELECT+2+AS+src%2C+%22PERMIT+%23%22+AS+permit%2C+%22PERMIT+TYPE%22+AS+ptype%2C+%22PROJECT+NAME%22+AS+pname%2C+%22WORK+TYPE%22+AS+wtype%2C+%22ADDRESS%22+AS+addr%2C+%22X_COORD%22+AS+x%2C+%22Y_COORD%22+AS+y%2C+left%28CAST%28%22DATE+SUBMITTED%22+AS+text%29%2C+10%29+AS+submitted%2C+left%28CAST%28%22DATE+ISSUED%22+AS+text%29%2C+10%29+AS+issued%2C+%22DECLARED+VALUATION%22+AS+val%2C+%22AREA+%28SF%29%22+AS+area%2C+%22PRIMARY+CONTACT%22+AS+contact%2C+%22CD%22+AS+cd+FROM+%22c22b1ef2-dcf8-4d77-be1a-ee3638092aab%22%29+p+WHERE+ptype+%3C%3E+%27Garage+Sale%27+AND+%28addr+ILIKE+%27%25717+N+Alamo+St%25%27+OR+%28addr+IS+NULL+AND+pname+ILIKE+%27%25717+N+Alamo+St%25%27%29%29+AND+issued+%3E%3D+%272022-01-01%27+AND+issued+%3C%3D+%272026-10-23%27+GROUP+BY+permit+ORDER+BY+issued+DESC%2C+permit+DESC+LIMIT+25" } ```