---
type: "firecrawl-provider"
description: "USA Structures building inventory (FEMA Response Geospatial Office and Oak Ridge National Laboratory): per-state file status from the FEMA Geospatial Resource Center hub page and the public S3 bucket (size, ETag, version id, Last-Modified, release date, optional FGDC metadata), county-segmented structure records paged by OBJECTID from the hosted ArcGIS view with a cursor pinned to the view's dataLastEditDate, and single structures by OBJECTID. Anonymous, keyless, read-only."
use_when: "USA Structures building inventory (FEMA Response Geospatial Office and Oak Ridge National Laboratory): per-state file status from the FEMA Geospatial Resource Center hub page and the public S3 bucket (size, ETag, version id, Last-Modified, release date, optional FGDC metadata), county-segmented structure records paged by OBJECTID from the hosted ArcGIS view with a cursor pinned to the view's dataLastEditDate, and single structures by OBJECTID. Anonymous, keyless, read-only."
categories: "Real estate"
capabilities: 3
credits_per_call: 5
---
# FEMA / ORNL USA Structures on Firecrawl Alexandria

USA Structures building inventory (FEMA Response Geospatial Office and Oak Ridge National Laboratory): per-state file status from the FEMA Geospatial Resource Center hub page and the public S3 bucket (size, ETag, version id, Last-Modified, release date, optional FGDC metadata), county-segmented structure records paged by OBJECTID from the hosted ArcGIS view with a cursor pinned to the view's dataLastEditDate, and single structures by OBJECTID. Anonymous, keyless, read-only.

- Categories: Real estate
- Category index: [Real estate category](https://firecrawl.dev/alexandria/agents/categories/real-estate)
- Provider key: `gis-fema-hub-arcgis-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/gis-fema-hub-arcgis-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/gis-fema-hub-arcgis-com/openapi.json)

## Capabilities

- [Records get](https://firecrawl.dev/alexandria/agents/providers/gis-fema-hub-arcgis-com/building-footprints/records_get): One USA Structures row by hosted-view OBJECTID (the only indexed single-record key; UUID lookups are not indexed upstream and time out). Returns the same record shape as records_list plus the view's vintage. An unknown OBJECTID is not_found.
- [Records list](https://firecrawl.dev/alexandria/agents/providers/gis-fema-hub-arcgis-com/building-footprints/records_list): Structures of one county from the USA Structures hosted view (USA_Structures_View layer 0 on services2.arcgis.com), as attribute rows without geometry. Segment key: five-digit county FIPS (indexed), optional OCC_CLS filter (indexed; e.g. Residential). Keyset pagination on OBJECTID, up to 2,000 rows per page (`page_size`), ordered by OBJECTID. The first page also returns the segment's total_count. The cursor pins the view's dataLastEditDate (publication_id) and the segment; every page re-reads the layer metadata and, if the view has been republished since the cursor was issued, fails with invalid_input issue code `publication_changed` instead of mixing vintages. Rows carry source_record_id (ORNL UUID), objectid, publication_id, source_url and retrieved_at plus the mapped fields (BUILD_ID, OCC_CLS, PRIM_OCC, SEC_OCC, PROP_* address, FIPS, STATE_FIPS, CENSUSCODE tract, LONGITUDE/LATITUDE centroid in WGS 84, SQFEET, SQMETERS, HEIGHT, OUTBLDG, IMAGE_DATE, IMAGE_NAME, PROD_DATE, SOURCE, VAL_METHOD, POP_*, B_CODE, USNG, GlobalID). The view's data currency (June 2025) is older than the 2026 state files; see `view`. CENSUSCODE and UUID are not indexed upstream and are not offered as filters.
- [Source status](https://firecrawl.dev/alexandria/agents/providers/gis-fema-hub-arcgis-com/building-footprints/source_status): Cheap version check of the USA Structures publication. Reads the hub downloads page (portal item data) for the current state zip link of every state and territory (56 rows; the bucket listing omits current files, so the page is authoritative), HEADs each zip on the public S3 bucket for size, ETag (multipart MD5, the publisher's only posted hash), x-amz-version-id and Last-Modified, derives the release date from the file name (PR_Structures_20260913 -> 2026-09-13; Deliverable20250606TX -> 2025-06-06), and reports the hosted view's dataLastEditDate as the records publication id. With `state` set, adds the view's row count for that state; with `include_fgdc` (one state only) two or three S3 range reads parse the zip central directory and the embedded FGDC metadata XML (publication date, imagery date range, access and use constraints). Every state file exceeds the 32 MiB fetch cap (only the small territories AS, GU, MP, VI and DC fit), so `handoff` is true for them: download the file_url out of band and use records_list for rows.

## 1. Choose this provider when

USA Structures building inventory (FEMA Response Geospatial Office and Oak Ridge National Laboratory): per-state file status from the FEMA Geospatial Resource Center hub page and the public S3 bucket (size, ETag, version id, Last-Modified, release date, optional FGDC metadata), county-segmented structure records paged by OBJECTID from the hosted ArcGIS view with a cursor pinned to the view's dataLastEditDate, and single structures by OBJECTID. Anonymous, keyless, read-only.

## 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": "gis-fema-hub-arcgis-com",
  "capability": "building-footprints/records_get",
  "options": {
    "objectid": 103038029
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `objectid` (number, required): Hosted view OBJECTID, e.g. 103038029. Example: `10`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "gis-fema-hub-arcgis-com",
    capability: "building-footprints/records_get",
    options: {
      objectid: 103038029,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "gis-fema-hub-arcgis-com",
  "capability": "building-footprints/records_get",
  "options": {
    "objectid": 103038029
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "gis-fema-hub-arcgis-com",
    "capability": "building-footprints/records_get",
    "options": {
      "objectid": 103038029
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'gis-fema-hub-arcgis-com/building-footprints/records_get' \
  --options '{"objectid":103038029}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "gis-fema-hub-arcgis-com",
  "capability": "building-footprints/records_get",
  "options": {
    "objectid": 103038029
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "gis-fema-hub-arcgis-com",
  "capability": "building-footprints/records_get",
  "options": {
    "objectid": 103038029
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "license_note": "The hosted view item states CC BY 4.0; the FGDC metadata in the zips states access and use constraints 'None'; ORNL is contractor-operated, so 17 USC 105 is not assumed. Treat as attribution-required: FEMA Response Geospatial Office / Oak Ridge National Laboratory, USA Structures.",
  "observed_at_ms": 1792305097210,
  "provenance_note": "OCC_CLS, PRIM_OCC, SEC_OCC and PROP_ADDR/PROP_CITY/PROP_ZIP are parcel-derived (LightBox SmartParcels and HERE inputs per the Nature descriptor s41597-024-03219-x); flag as parcel-derived until FEMA confirms redistribution terms.",
  "publication_id": "view:1758662435029",
  "record": {
    "b_code": null,
    "build_id": 735830,
    "censuscode": "72045952100",
    "crs": "EPSG:4326",
    "fips": "72045",
    "global_id": "6630aaa3-8727-41e9-a377-606782b8fdfa",
    "h_adj_elev": null,
    "height": null,
    "image_date": "2018-06-04",
    "image_date_ms": 1528070400000,
    "image_name": "103001007DD1F700",
    "l_adj_elev": null,
    "latitude": 18.1832754846399,
    "longitude": -66.2302238312838,
    "objectid": 103038029,
    "occ_cls": "Unclassified",
    "outbldg": null,
    "pop_ci95_lower": null,
    "pop_ci95_upper": null,
    "pop_median": null,
    "prim_occ": "Unclassified",
    "prod_date": "2019-05-30",
    "prod_date_ms": 1559174400000,
    "prop_addr": null,
    "prop_city": null,
    "prop_cnty": "Comerío",
    "prop_st": "Puerto Rico",
    "prop_zip": null,
    "publication_id": "view:1758662435029",
    "remarks": null,
    "retrieved_at": "2026-10-18T06:31:37.210Z",
    "sec_occ": null,
    "shape_area_m2": 54.5087890625,
    "shape_length_m": 31.29256889114981,
    "source": "ORNL",
    "source_record_id": "{af5fa851-6753-4049-9089-aed0c06ebe71}",
    "source_url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0/query?f=json&objectIds=103038029&outFields=*&returnGeometry=false",
    "sqfeet": 527.4348,
    "sqmeters": 56.28817,
    "state_fips": "72",
    "usng": "19Q GA 93003 12673",
    "uuid": "{af5fa851-6753-4049-9089-aed0c06ebe71}",
    "val_method": "Automated"
  },
  "retrieved_at": "2026-10-18T06:31:37.210Z",
  "source_url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0/query?f=json&objectIds=103038029&outFields=*&returnGeometry=false",
  "view": {
    "data_last_edit_date": "2025-09-23T21:20:35.029Z",
    "data_last_edit_ms": 1758662435029,
    "last_edit_date": "2026-06-08T18:21:34.830Z",
    "last_edit_ms": 1780942894830,
    "max_record_count": 2000,
    "publication_id": "view:1758662435029",
    "schema_last_edit_date": "2025-10-14T22:09:11.713Z",
    "url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0"
  }
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Records get

- Capability: `building-footprints/records_get`
- Description: One USA Structures row by hosted-view OBJECTID (the only indexed single-record key; UUID lookups are not indexed upstream and time out). Returns the same record shape as records_list plus the view's vintage. An unknown OBJECTID is not_found.
- Instructions: Re-read or verify one structure whose objectid came from records_list.
- Cost: 5 credits per call
- Capability file: [Records get](https://firecrawl.dev/alexandria/agents/providers/gis-fema-hub-arcgis-com/building-footprints/records_get)

Accepted options:
- `objectid` (number, required): Hosted view OBJECTID, e.g. 103038029. Example: `10`

Response schema example:
```json
{
  "license_note": "The hosted view item states CC BY 4.0; the FGDC metadata in the zips states access and use constraints 'None'; ORNL is contractor-operated, so 17 USC 105 is not assumed. Treat as attribution-required: FEMA Response Geospatial Office / Oak Ridge National Laboratory, USA Structures.",
  "observed_at_ms": 1792305097210,
  "provenance_note": "OCC_CLS, PRIM_OCC, SEC_OCC and PROP_ADDR/PROP_CITY/PROP_ZIP are parcel-derived (LightBox SmartParcels and HERE inputs per the Nature descriptor s41597-024-03219-x); flag as parcel-derived until FEMA confirms redistribution terms.",
  "publication_id": "view:1758662435029",
  "record": {
    "b_code": null,
    "build_id": 735830,
    "censuscode": "72045952100",
    "crs": "EPSG:4326",
    "fips": "72045",
    "global_id": "6630aaa3-8727-41e9-a377-606782b8fdfa",
    "h_adj_elev": null,
    "height": null,
    "image_date": "2018-06-04",
    "image_date_ms": 1528070400000,
    "image_name": "103001007DD1F700",
    "l_adj_elev": null,
    "latitude": 18.1832754846399,
    "longitude": -66.2302238312838,
    "objectid": 103038029,
    "occ_cls": "Unclassified",
    "outbldg": null,
    "pop_ci95_lower": null,
    "pop_ci95_upper": null,
    "pop_median": null,
    "prim_occ": "Unclassified",
    "prod_date": "2019-05-30",
    "prod_date_ms": 1559174400000,
    "prop_addr": null,
    "prop_city": null,
    "prop_cnty": "Comerío",
    "prop_st": "Puerto Rico",
    "prop_zip": null,
    "publication_id": "view:1758662435029",
    "remarks": null,
    "retrieved_at": "2026-10-18T06:31:37.210Z",
    "sec_occ": null,
    "shape_area_m2": 54.5087890625,
    "shape_length_m": 31.29256889114981,
    "source": "ORNL",
    "source_record_id": "{af5fa851-6753-4049-9089-aed0c06ebe71}",
    "source_url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0/query?f=json&objectIds=103038029&outFields=*&returnGeometry=false",
    "sqfeet": 527.4348,
    "sqmeters": 56.28817,
    "state_fips": "72",
    "usng": "19Q GA 93003 12673",
    "uuid": "{af5fa851-6753-4049-9089-aed0c06ebe71}",
    "val_method": "Automated"
  },
  "retrieved_at": "2026-10-18T06:31:37.210Z",
  "source_url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0/query?f=json&objectIds=103038029&outFields=*&returnGeometry=false",
  "view": {
    "data_last_edit_date": "2025-09-23T21:20:35.029Z",
    "data_last_edit_ms": 1758662435029,
    "last_edit_date": "2026-06-08T18:21:34.830Z",
    "last_edit_ms": 1780942894830,
    "max_record_count": 2000,
    "publication_id": "view:1758662435029",
    "schema_last_edit_date": "2025-10-14T22:09:11.713Z",
    "url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0"
  }
}
```

### Records list

- Capability: `building-footprints/records_list`
- Description: Structures of one county from the USA Structures hosted view (USA_Structures_View layer 0 on services2.arcgis.com), as attribute rows without geometry. Segment key: five-digit county FIPS (indexed), optional OCC_CLS filter (indexed; e.g. Residential). Keyset pagination on OBJECTID, up to 2,000 rows per page (`page_size`), ordered by OBJECTID. The first page also returns the segment's total_count. The cursor pins the view's dataLastEditDate (publication_id) and the segment; every page re-reads the layer metadata and, if the view has been republished since the cursor was issued, fails with invalid_input issue code `publication_changed` instead of mixing vintages. Rows carry source_record_id (ORNL UUID), objectid, publication_id, source_url and retrieved_at plus the mapped fields (BUILD_ID, OCC_CLS, PRIM_OCC, SEC_OCC, PROP_* address, FIPS, STATE_FIPS, CENSUSCODE tract, LONGITUDE/LATITUDE centroid in WGS 84, SQFEET, SQMETERS, HEIGHT, OUTBLDG, IMAGE_DATE, IMAGE_NAME, PROD_DATE, SOURCE, VAL_METHOD, POP_*, B_CODE, USNG, GlobalID). The view's data currency (June 2025) is older than the 2026 state files; see `view`. CENSUSCODE and UUID are not indexed upstream and are not offered as filters.
- Instructions: Collect every structure of a county (optionally one occupancy class) page by page; resume with next_cursor until it is null.
- Cost: 5 credits per call
- Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/gis-fema-hub-arcgis-com/building-footprints/records_list)

Accepted options:
- `cursor` (string): next_cursor from the previous page (opaque; pins publication and segment). Example: `<cursor>`
- `fips` (string, required): Five-digit county FIPS, e.g. 72045 (Comerío, PR) or 02060 (Bristol Bay, AK). Pattern: ^[0-9]{5}$. Example: `<fips>`
- `occ_cls` (string): Optional occupancy class filter (exact upstream value): Residential, Commercial, Industrial, Agriculture, Government, Education, Assembly, Utility and Misc, Unclassified. Pattern: ^[A-Za-z0-9 &/-]+$. Example: `<occ_cls>`
- `page_size` (number): Rows per page; the view's maxRecordCount is 2000. Example: `2000`

Response schema example:
```json
{
  "count": 3,
  "exceeded_transfer_limit": true,
  "license_note": "The hosted view item states CC BY 4.0; the FGDC metadata in the zips states access and use constraints 'None'; ORNL is contractor-operated, so 17 USC 105 is not assumed. Treat as attribution-required: FEMA Response Geospatial Office / Oak Ridge National Laboratory, USA Structures.",
  "next_cursor": "v1|view:1758662435029|72045|Residential|103039967",
  "observed_at_ms": 1792305107841,
  "page_size": 3,
  "provenance_note": "OCC_CLS, PRIM_OCC, SEC_OCC and PROP_ADDR/PROP_CITY/PROP_ZIP are parcel-derived (LightBox SmartParcels and HERE inputs per the Nature descriptor s41597-024-03219-x); flag as parcel-derived until FEMA confirms redistribution terms.",
  "publication_id": "view:1758662435029",
  "records": [
    {
      "b_code": null,
      "build_id": 737283,
      "censuscode": "72045952100",
      "crs": "EPSG:4326",
      "fips": "72045",
      "global_id": "68421dc2-7b0f-4768-8349-6770169ab6a1",
      "h_adj_elev": null,
      "height": null,
      "image_date": "2018-06-04",
      "image_date_ms": 1528070400000,
      "image_name": "103001007DD1F700",
      "l_adj_elev": null,
      "latitude": 18.1839061930391,
      "longitude": -66.2307225936539,
      "objectid": 103038898,
      "occ_cls": "Residential",
      "outbldg": null,
      "pop_ci95_lower": null,
      "pop_ci95_upper": null,
      "pop_median": null,
      "prim_occ": "Single Family Dwelling",
      "prod_date": "2019-05-30",
      "prod_date_ms": 1559174400000,
      "prop_addr": null,
      "prop_city": null,
      "prop_cnty": "Comerío",
      "prop_st": "Puerto Rico",
      "prop_zip": null,
      "publication_id": "view:1758662435029",
      "remarks": null,
      "retrieved_at": "2026-10-18T06:31:47.841Z",
      "sec_occ": null,
      "shape_area_m2": 132.865234375,
      "shape_length_m": 49.62673730834011,
      "source": "ORNL",
      "source_record_id": "{b349ee4f-9e4a-4015-874e-4934c5e78ba2}",
      "source_url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0/query?f=json&objectIds=103038898&outFields=*&returnGeometry=false",
      "sqfeet": 1285.61,
      "sqmeters": 139.2095,
      "state_fips": "72",
      "usng": "19Q GA 92950 12743",
      "uuid": "{b349ee4f-9e4a-4015-874e-4934c5e78ba2}",
      "val_method": "Automated"
    },
    {
      "b_code": null,
      "build_id": 735981,
      "censuscode": "72045952100",
      "crs": "EPSG:4326",
      "fips": "72045",
      "global_id": "9f8bbed8-a0f6-4634-93a6-419fb79ef666",
      "h_adj_elev": null,
      "height": null,
      "image_date": "2018-06-04",
      "image_date_ms": 1528070400000,
      "image_name": "103001007DD1F700",
      "l_adj_elev": null,
      "latitude": 18.1833292409636,
      "longitude": -66.2306896339835,
      "objectid": 103039465,
      "occ_cls": "Residential",
      "outbldg": null,
      "pop_ci95_lower": null,
      "pop_ci95_upper": null,
      "pop_median": null,
      "prim_occ": "Single Family Dwelling",
      "prod_date": "2019-05-30",
      "prod_date_ms": 1559174400000,
      "prop_addr": null,
      "prop_city": null,
      "prop_cnty": "Comerío",
      "prop_st": "Puerto Rico",
      "prop_zip": null,
      "publication_id": "view:1758662435029",
      "remarks": null,
      "retrieved_at": "2026-10-18T06:31:47.841Z",
      "sec_occ": null,
      "shape_area_m2": 61.322265625,
      "shape_length_m": 33.97240092166231,
      "source": "ORNL",
      "source_record_id": "{f174acbe-88a8-476a-8028-5dd36d030743}",
      "source_url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0/query?f=json&objectIds=103039465&outFields=*&returnGeometry=false",
      "sqfeet": 593.3583,
      "sqmeters": 64.79823,
      "state_fips": "72",
      "usng": "19Q GA 92954 12678",
      "uuid": "{f174acbe-88a8-476a-8028-5dd36d030743}",
      "val_method": "Automated"
    },
    {
      "b_code": null,
      "build_id": 736528,
      "censuscode": "72045952100",
      "crs": "EPSG:4326",
      "fips": "72045",
      "global_id": "e6713878-062a-4dfc-8d84-81101b0fb5ed",
      "h_adj_elev": null,
      "height": null,
      "image_date": "2018-06-04",
      "image_date_ms": 1528070400000,
      "image_name": "103001007DD1F700",
      "l_adj_elev": null,
      "latitude": 18.1835949627102,
      "longitude": -66.2307396123104,
      "objectid": 103039967,
      "occ_cls": "Residential",
      "outbldg": null,
      "pop_ci95_lower": null,
      "pop_ci95_upper": null,
      "pop_median": null,
      "prim_occ": "Single Family Dwelling",
      "prod_date": "2019-05-30",
      "prod_date_ms": 1559174400000,
      "prop_addr": null,
      "prop_city": null,
      "prop_cnty": "Comerío",
      "prop_st": "Puerto Rico",
      "prop_zip": null,
      "publication_id": "view:1758662435029",
      "remarks": null,
      "retrieved_at": "2026-10-18T06:31:47.841Z",
      "sec_occ": null,
      "shape_area_m2": 190.7841796875,
      "shape_length_m": 57.382119941861774,
      "source": "ORNL",
      "source_record_id": "{1b60bdec-8af8-4195-b418-e42c1d8f4f3f}",
      "source_url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0/query?f=json&objectIds=103039967&outFields=*&returnGeometry=false",
      "sqfeet": 1846.024,
      "sqmeters": 169.1376,
      "state_fips": "72",
      "usng": "19Q GA 92947 12708",
      "uuid": "{1b60bdec-8af8-4195-b418-e42c1d8f4f3f}",
      "val_method": "Automated"
    }
  ],
  "retrieved_at": "2026-10-18T06:31:47.841Z",
  "segment": {
    "fips": "72045",
    "occ_cls": "Residential"
  },
  "source_url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0/query?f=json&where=FIPS%3D%2772045%27%20AND%20OCC_CLS%3D%27Residential%27%20AND%20OBJECTID%3E0&orderByFields=OBJECTID&resultRecordCount=3&returnGeometry=false&outFields=*",
  "total_count": 1857,
  "view": {
    "data_last_edit_date": "2025-09-23T21:20:35.029Z",
    "data_last_edit_ms": 1758662435029,
    "last_edit_date": "2026-06-08T18:21:34.830Z",
    "last_edit_ms": 1780942894830,
    "max_record_count": 2000,
    "publication_id": "view:1758662435029",
    "schema_last_edit_date": "2025-10-14T22:09:11.713Z",
    "url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0"
  }
}
```

### Source status

- Capability: `building-footprints/source_status`
- Description: Cheap version check of the USA Structures publication. Reads the hub downloads page (portal item data) for the current state zip link of every state and territory (56 rows; the bucket listing omits current files, so the page is authoritative), HEADs each zip on the public S3 bucket for size, ETag (multipart MD5, the publisher's only posted hash), x-amz-version-id and Last-Modified, derives the release date from the file name (PR_Structures_20260913 -> 2026-09-13; Deliverable20250606TX -> 2025-06-06), and reports the hosted view's dataLastEditDate as the records publication id. With `state` set, adds the view's row count for that state; with `include_fgdc` (one state only) two or three S3 range reads parse the zip central directory and the embedded FGDC metadata XML (publication date, imagery date range, access and use constraints). Every state file exceeds the 32 MiB fetch cap (only the small territories AS, GU, MP, VI and DC fit), so `handoff` is true for them: download the file_url out of band and use records_list for rows.
- Instructions: Before a collection run: detect a new release per state (publication_id, etag, version_id, last_modified) and get the file hand-off details.
- Cost: 5 credits per call
- Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/gis-fema-hub-arcgis-com/building-footprints/source_status)

Accepted options:
- `include_fgdc` (boolean): Read the FGDC metadata XML from inside the zip with S3 range reads (publication date, imagery dates, constraints). Requires `state`. Example: `false`
- `state` (string): USPS code (PR, AK, TX) or name (Puerto Rico) of one state or territory. Omit for all 56 rows of the hub table. Example: `<state>`

Response schema example:
```json
{
  "handoff": {
    "limit_bytes": 33554432,
    "note": "A state zip with handoff=true exceeds the 32 MiB runner fetch cap (every state; only the small territories AS, GU, MP, VI and DC fit) and every zip holds the feature table as one deflate entry, so records are never read from the files: download the file_url out of band (ETag and x-amz-version-id identify the object; Range is supported) and use records_list for row access on the hosted view."
  },
  "observed_at_ms": 1792305112760,
  "retrieved_at": "2026-10-18T06:31:52.760Z",
  "source": {
    "hub_page_item_id": "8388995e228e4e30a882686ac3ab256e",
    "hub_page_modified": "2026-10-01T16:29:17.000Z",
    "hub_page_modified_ms": 1790872157000,
    "hub_page_url": "https://gis-fema.hub.arcgis.com/pages/usa-structures-data",
    "license_note": "The hosted view item states CC BY 4.0; the FGDC metadata in the zips states access and use constraints 'None'; ORNL is contractor-operated, so 17 USC 105 is not assumed. Treat as attribution-required: FEMA Response Geospatial Office / Oak Ridge National Laboratory, USA Structures.",
    "name": "USA Structures (FEMA Response Geospatial Office / Oak Ridge National Laboratory)",
    "provenance_note": "OCC_CLS, PRIM_OCC, SEC_OCC and PROP_ADDR/PROP_CITY/PROP_ZIP are parcel-derived (LightBox SmartParcels and HERE inputs per the Nature descriptor s41597-024-03219-x); flag as parcel-derived until FEMA confirms redistribution terms."
  },
  "state_count": 1,
  "states": [
    {
      "content_hash": {
        "algorithm": "s3-etag",
        "value": "cd198dadccfa30bd9bf6e27436f1ac01-13"
      },
      "content_type": "application/zip",
      "etag": "cd198dadccfa30bd9bf6e27436f1ac01-13",
      "fgdc": {
        "accconst": "None",
        "entry_name": "PR_Structures_metadata.xml",
        "image_begdate": "2011-10-23",
        "image_enddate": "2026-06-19",
        "metadata_date": "2026-08-10",
        "origin": "Oak Ridge National Laboratory",
        "pubdate": "2026-09-13",
        "title": "PR_Structures",
        "useconst": "None"
      },
      "file_name": "PR_Structures_20260913.zip",
      "file_url": "https://fema-femadata.s3.us-east-1.amazonaws.com/Partners/ORNL/USA_Structures/Puerto+Rico/PR_Structures_20260913.zip",
      "handoff": true,
      "hub_table_name": "Puerto Rico",
      "last_modified": "2026-09-22T20:28:16.000Z",
      "last_modified_raw": "Tue, 22 Sep 2026 20:28:16 GMT",
      "naming": "structures",
      "publication_id": "PR_Structures_20260913",
      "release_date": "2026-09-13",
      "size_bytes": 212477595,
      "state": "PR",
      "state_fips": "72",
      "state_name": "Puerto Rico",
      "version_id": "d2pB6Mq_enqWcuoKPhW6_70XpOF43p7b",
      "view_record_count": 1194236
    }
  ],
  "view": {
    "data_last_edit_date": "2025-09-23T21:20:35.029Z",
    "data_last_edit_ms": 1758662435029,
    "last_edit_date": "2026-06-08T18:21:34.830Z",
    "last_edit_ms": 1780942894830,
    "max_record_count": 2000,
    "publication_id": "view:1758662435029",
    "schema_last_edit_date": "2025-10-14T22:09:11.713Z",
    "url": "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/USA_Structures_View/FeatureServer/0"
  }
}
```
