--- type: "firecrawl-provider" description: "U.S. Department of Transportation National Address Database from its public release files on data.transportation.gov: quarterly release status (TXT and File Geodatabase zips, the CSV member, row count, licence) and every address-point row of the TXT release, paged in file order with byte-range reads and a publication-pinned cursor. Public domain (17 U.S.C. 105); the publisher states the NAD is not intended for use as a mailing list." use_when: "U.S. Department of Transportation National Address Database from its public release files on data.transportation.gov: quarterly release status (TXT and File Geodatabase zips, the CSV member, row count, licence) and every address-point row of the TXT release, paged in file order with byte-range reads and a publication-pinned cursor. Public domain (17 U.S.C. 105); the publisher states the NAD is not intended for use as a mailing list." categories: "Public records" capabilities: 2 credits_per_call: 5 --- # USDOT National Address Database (NAD) on Firecrawl Alexandria U.S. Department of Transportation National Address Database from its public release files on data.transportation.gov: quarterly release status (TXT and File Geodatabase zips, the CSV member, row count, licence) and every address-point row of the TXT release, paged in file order with byte-range reads and a publication-pinned cursor. Public domain (17 U.S.C. 105); the publisher states the NAD is not intended for use as a mailing list. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `data-transportation-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/data-transportation-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/data-transportation-gov/openapi.json) ## Capabilities - [Records list](https://firecrawl.dev/alexandria/agents/providers/data-transportation-gov/addresses/records_list): Every NAD address point of the current release, read from the Deflate64 CSV inside TXT.zip in file order (rows are grouped by state and county on disk, not sorted by OID_). Each page reads only the compressed byte range it needs: the cursor carries the release blob id, a Deflate64 block boundary and the 64 KiB of text before it. When the release is replaced mid-run the call fails with invalid_input and issue code publication_changed instead of mixing releases. Records carry all 60 columns plus normalized address, place and coordinate fields. - [Source status](https://firecrawl.dev/alexandria/agents/providers/data-transportation-gov/addresses/source_status): Current NAD release: release id, compile date, the TXT and File Geodatabase download URLs with size and blob ETag, the CSV member inside TXT.zip (name, Deflate64, CRC-32, compressed and uncompressed size) from the ZIP64 central directory, the row count from the release preview attachment, and the licence text from the metadata XML in the zip. ## 1. Choose this provider when U.S. Department of Transportation National Address Database from its public release files on data.transportation.gov: quarterly release status (TXT and File Geodatabase zips, the CSV member, row count, licence) and every address-point row of the TXT release, paged in file order with byte-range reads and a publication-pinned cursor. Public domain (17 U.S.C. 105); the publisher states the NAD is not intended for use as a mailing list. ## 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-transportation-gov", "capability": "addresses/records_list", "options": { "page_size": 2 } } ``` ## 3. Add provider options Use only the options needed for the task: - `cursor` (string): next_cursor from the previous page. Carries the pinned release and the resume point (about 20 KB, most of it the compressed 64 KiB window); treat it as opaque. Example: `` - `page_size` (number): Rows per page. Example: `1000` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "data-transportation-gov", capability: "addresses/records_list", options: { page_size: 2, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "data-transportation-gov", "capability": "addresses/records_list", "options": { "page_size": 2 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "data-transportation-gov", "capability": "addresses/records_list", "options": { "page_size": 2 } } }' ``` ### CLI ```sh firecrawl scrape 'data-transportation-gov/addresses/records_list' \ --options '{"page_size":2}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "data-transportation-gov", "capability": "addresses/records_list", "options": { "page_size": 2 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "data-transportation-gov", "capability": "addresses/records_list", "options": { "page_size": 2 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "call_ms": 471, "count": 2, "first_row": 1, "last_row": 2, "next_cursor": "nad2.596a301b-d548-4589-8c63-6b6a8dc34f30.r24.42111724256.83104.1388.0.2.AwA", "observed_at_ms": 1792889963434, "page_size": 2, "position": { "text_bytes": 42111724256, "text_offset": 1388 }, "publication": { "blob_id": "596a301b-d548-4589-8c63-6b6a8dc34f30", "compiled_on": "2026-09-30", "file_url": "https://data.transportation.gov/api/views/fc2s-wawr/files/596a301b-d548-4589-8c63-6b6a8dc34f30?download=true&filename=TXT.zip", "id": "files:r24:596a301b-d548-4589-8c63-6b6a8dc34f30", "release": "r24" }, "records": [ { "add_auth": "BOURNE", "addr_class": "Numbered Thoroughfare Address", "addr_type": "RESIDENTIAL", "address": "114 SOUTH Road", "attributes": { "AddAuth": "BOURNE", "AddNo_Full": "114", "AddNum_Pre": null, "AddNum_Suf": null, "Add_Number": "114", "AddrClass": "Numbered Thoroughfare Address", "AddrPoint": "-70.64536041699995 41.68531855700007", "AddrRefSys": "UNINC_COMM", "Addr_Type": "RESIDENTIAL", "Addtl_Loc": null, "AnomStatus": null, "Building": null, "Census_Plc": null, "County": "Barnstable", "DataSet_ID": "{8AD0EF97-3CF8-CF85-7AE0-03FAA16683D2}", "DateUpdate": "2024-02-02 00:00:00", "DeliverTyp": null, "Effective": null, "Elevation": null, "Expire": null, "Floor": null, "Inc_Muni": "BOURNE", "LandmkName": null, "Latitude": "41.68531855700007", "Lifecycle": null, "LocatnDesc": null, "Longitude": "-70.64536041699995", "NAD_Source": "BOSTON and MASSGIS Massachusetts", "NatAmArea": null, "NatAmSub": null, "NatGrid": "19TCG6306316146", "Nbrhd_Comm": null, "OID_": "1", "ParcelSrc": null, "Parcel_ID": null, "PlaceNmTyp": null, "PlaceOther": null, "Placement": "Site", "Plus_4": null, "Post_City": "Not stated", "RelateType": null, "Related_ID": null, "Room": null, "Seat": null, "StNam_Full": "SOUTH Road", "St_Name": "SOUTH", "St_PosDir": null, "St_PosMod": null, "St_PosTyp": "Road", "St_PreDir": null, "St_PreMod": null, "St_PreSep": null, "St_PreTyp": null, "State": "MA", "SubAddress": null, "UUID": "{8AD0EF97-3CF8-CF85-7AE0-03FAA16683D2}", "Uninc_Comm": "BOURNE", "Unit": null, "Urbnztn_PR": null, "Zip_Code": "02559" }, "county": "Barnstable", "date_updated": "2024-02-02", "latitude": 41.68531855700007, "longitude": -70.64536041699995, "nad_source": "BOSTON and MASSGIS Massachusetts", "oid": 1, "placement": "Site", "post_city": "Not stated", "publication_id": "files:r24:596a301b-d548-4589-8c63-6b6a8dc34f30", "retrieved_at": "2026-10-25T00:59:23Z", "row": 1, "source_record_id": "8ad0ef97-3cf8-cf85-7ae0-03faa16683d2", "source_url": "https://data.transportation.gov/api/views/fc2s-wawr/files/596a301b-d548-4589-8c63-6b6a8dc34f30?download=true&filename=TXT.zip", "state": "MA", "zip_code": "02559" }, { "add_auth": "BOURNE", "addr_class": "Numbered Thoroughfare Address", "addr_type": "RESIDENTIAL", "address": "67 PASTURE Road", "attributes": { "AddAuth": "BOURNE", "AddNo_Full": "67", "AddNum_Pre": null, "AddNum_Suf": null, "Add_Number": "67", "AddrClass": "Numbered Thoroughfare Address", "AddrPoint": "-70.64532041599995 41.66077855200007", "AddrRefSys": "UNINC_COMM", "Addr_Type": "RESIDENTIAL", "Addtl_Loc": null, "AnomStatus": null, "Building": null, "Census_Plc": null, "County": "Barnstable", "DataSet_ID": "{8AD0EF97-647E-47E5-7AE0-03FAA16683D2}", "DateUpdate": "2013-12-05 00:00:00", "DeliverTyp": null, "Effective": null, "Elevation": null, "Expire": null, "Floor": null, "Inc_Muni": "BOURNE", "LandmkName": null, "Latitude": "41.66077855200007", "Lifecycle": null, "LocatnDesc": null, "Longitude": "-70.64532041599995", "NAD_Source": "BOSTON and MASSGIS Massachusetts", "NatAmArea": null, "NatAmSub": null, "NatGrid": "19TCG6301413421", "Nbrhd_Comm": null, "OID_": "2", "ParcelSrc": null, "Parcel_ID": null, "PlaceNmTyp": null, "PlaceOther": null, "Placement": "Structure - Rooftop", "Plus_4": null, "Post_City": "Not stated", "RelateType": null, "Related_ID": null, "Room": null, "Seat": null, "StNam_Full": "PASTURE Road", "St_Name": "PASTURE", "St_PosDir": null, "St_PosMod": null, "St_PosTyp": "Road", "St_PreDir": null, "St_PreMod": null, "St_PreSep": null, "St_PreTyp": null, "State": "MA", "SubAddress": null, "UUID": "{8AD0EF97-647E-47E5-7AE0-03FAA16683D2}", "Uninc_Comm": "BOURNE", "Unit": null, "Urbnztn_PR": null, "Zip_Code": "02534" }, "county": "Barnstable", "date_updated": "2013-12-05", "latitude": 41.66077855200007, "longitude": -70.64532041599995, "nad_source": "BOSTON and MASSGIS Massachusetts", "oid": 2, "placement": "Structure - Rooftop", "post_city": "Not stated", "publication_id": "files:r24:596a301b-d548-4589-8c63-6b6a8dc34f30", "retrieved_at": "2026-10-25T00:59:23Z", "row": 2, "source_record_id": "8ad0ef97-647e-47e5-7ae0-03faa16683d2", "source_url": "https://data.transportation.gov/api/views/fc2s-wawr/files/596a301b-d548-4589-8c63-6b6a8dc34f30?download=true&filename=TXT.zip", "state": "MA", "zip_code": "02534" } ] } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Records list - Capability: `addresses/records_list` - Description: Every NAD address point of the current release, read from the Deflate64 CSV inside TXT.zip in file order (rows are grouped by state and county on disk, not sorted by OID_). Each page reads only the compressed byte range it needs: the cursor carries the release blob id, a Deflate64 block boundary and the 64 KiB of text before it. When the release is replaced mid-run the call fails with invalid_input and issue code publication_changed instead of mixing releases. Records carry all 60 columns plus normalized address, place and coordinate fields. - Instructions: Collect the whole NAD release (about 99 million rows), or its first rows as a sample; pass next_cursor back until it is null. - Cost: 5 credits per call - Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/data-transportation-gov/addresses/records_list) Accepted options: - `cursor` (string): next_cursor from the previous page. Carries the pinned release and the resume point (about 20 KB, most of it the compressed 64 KiB window); treat it as opaque. Example: `` - `page_size` (number): Rows per page. Example: `1000` Response schema example: ```json { "call_ms": 471, "count": 2, "first_row": 1, "last_row": 2, "next_cursor": "nad2.596a301b-d548-4589-8c63-6b6a8dc34f30.r24.42111724256.83104.1388.0.2.AwA", "observed_at_ms": 1792889963434, "page_size": 2, "position": { "text_bytes": 42111724256, "text_offset": 1388 }, "publication": { "blob_id": "596a301b-d548-4589-8c63-6b6a8dc34f30", "compiled_on": "2026-09-30", "file_url": "https://data.transportation.gov/api/views/fc2s-wawr/files/596a301b-d548-4589-8c63-6b6a8dc34f30?download=true&filename=TXT.zip", "id": "files:r24:596a301b-d548-4589-8c63-6b6a8dc34f30", "release": "r24" }, "records": [ { "add_auth": "BOURNE", "addr_class": "Numbered Thoroughfare Address", "addr_type": "RESIDENTIAL", "address": "114 SOUTH Road", "attributes": { "AddAuth": "BOURNE", "AddNo_Full": "114", "AddNum_Pre": null, "AddNum_Suf": null, "Add_Number": "114", "AddrClass": "Numbered Thoroughfare Address", "AddrPoint": "-70.64536041699995 41.68531855700007", "AddrRefSys": "UNINC_COMM", "Addr_Type": "RESIDENTIAL", "Addtl_Loc": null, "AnomStatus": null, "Building": null, "Census_Plc": null, "County": "Barnstable", "DataSet_ID": "{8AD0EF97-3CF8-CF85-7AE0-03FAA16683D2}", "DateUpdate": "2024-02-02 00:00:00", "DeliverTyp": null, "Effective": null, "Elevation": null, "Expire": null, "Floor": null, "Inc_Muni": "BOURNE", "LandmkName": null, "Latitude": "41.68531855700007", "Lifecycle": null, "LocatnDesc": null, "Longitude": "-70.64536041699995", "NAD_Source": "BOSTON and MASSGIS Massachusetts", "NatAmArea": null, "NatAmSub": null, "NatGrid": "19TCG6306316146", "Nbrhd_Comm": null, "OID_": "1", "ParcelSrc": null, "Parcel_ID": null, "PlaceNmTyp": null, "PlaceOther": null, "Placement": "Site", "Plus_4": null, "Post_City": "Not stated", "RelateType": null, "Related_ID": null, "Room": null, "Seat": null, "StNam_Full": "SOUTH Road", "St_Name": "SOUTH", "St_PosDir": null, "St_PosMod": null, "St_PosTyp": "Road", "St_PreDir": null, "St_PreMod": null, "St_PreSep": null, "St_PreTyp": null, "State": "MA", "SubAddress": null, "UUID": "{8AD0EF97-3CF8-CF85-7AE0-03FAA16683D2}", "Uninc_Comm": "BOURNE", "Unit": null, "Urbnztn_PR": null, "Zip_Code": "02559" }, "county": "Barnstable", "date_updated": "2024-02-02", "latitude": 41.68531855700007, "longitude": -70.64536041699995, "nad_source": "BOSTON and MASSGIS Massachusetts", "oid": 1, "placement": "Site", "post_city": "Not stated", "publication_id": "files:r24:596a301b-d548-4589-8c63-6b6a8dc34f30", "retrieved_at": "2026-10-25T00:59:23Z", "row": 1, "source_record_id": "8ad0ef97-3cf8-cf85-7ae0-03faa16683d2", "source_url": "https://data.transportation.gov/api/views/fc2s-wawr/files/596a301b-d548-4589-8c63-6b6a8dc34f30?download=true&filename=TXT.zip", "state": "MA", "zip_code": "02559" }, { "add_auth": "BOURNE", "addr_class": "Numbered Thoroughfare Address", "addr_type": "RESIDENTIAL", "address": "67 PASTURE Road", "attributes": { "AddAuth": "BOURNE", "AddNo_Full": "67", "AddNum_Pre": null, "AddNum_Suf": null, "Add_Number": "67", "AddrClass": "Numbered Thoroughfare Address", "AddrPoint": "-70.64532041599995 41.66077855200007", "AddrRefSys": "UNINC_COMM", "Addr_Type": "RESIDENTIAL", "Addtl_Loc": null, "AnomStatus": null, "Building": null, "Census_Plc": null, "County": "Barnstable", "DataSet_ID": "{8AD0EF97-647E-47E5-7AE0-03FAA16683D2}", "DateUpdate": "2013-12-05 00:00:00", "DeliverTyp": null, "Effective": null, "Elevation": null, "Expire": null, "Floor": null, "Inc_Muni": "BOURNE", "LandmkName": null, "Latitude": "41.66077855200007", "Lifecycle": null, "LocatnDesc": null, "Longitude": "-70.64532041599995", "NAD_Source": "BOSTON and MASSGIS Massachusetts", "NatAmArea": null, "NatAmSub": null, "NatGrid": "19TCG6301413421", "Nbrhd_Comm": null, "OID_": "2", "ParcelSrc": null, "Parcel_ID": null, "PlaceNmTyp": null, "PlaceOther": null, "Placement": "Structure - Rooftop", "Plus_4": null, "Post_City": "Not stated", "RelateType": null, "Related_ID": null, "Room": null, "Seat": null, "StNam_Full": "PASTURE Road", "St_Name": "PASTURE", "St_PosDir": null, "St_PosMod": null, "St_PosTyp": "Road", "St_PreDir": null, "St_PreMod": null, "St_PreSep": null, "St_PreTyp": null, "State": "MA", "SubAddress": null, "UUID": "{8AD0EF97-647E-47E5-7AE0-03FAA16683D2}", "Uninc_Comm": "BOURNE", "Unit": null, "Urbnztn_PR": null, "Zip_Code": "02534" }, "county": "Barnstable", "date_updated": "2013-12-05", "latitude": 41.66077855200007, "longitude": -70.64532041599995, "nad_source": "BOSTON and MASSGIS Massachusetts", "oid": 2, "placement": "Structure - Rooftop", "post_city": "Not stated", "publication_id": "files:r24:596a301b-d548-4589-8c63-6b6a8dc34f30", "retrieved_at": "2026-10-25T00:59:23Z", "row": 2, "source_record_id": "8ad0ef97-647e-47e5-7ae0-03faa16683d2", "source_url": "https://data.transportation.gov/api/views/fc2s-wawr/files/596a301b-d548-4589-8c63-6b6a8dc34f30?download=true&filename=TXT.zip", "state": "MA", "zip_code": "02534" } ] } ``` ### Source status - Capability: `addresses/source_status` - Description: Current NAD release: release id, compile date, the TXT and File Geodatabase download URLs with size and blob ETag, the CSV member inside TXT.zip (name, Deflate64, CRC-32, compressed and uncompressed size) from the ZIP64 central directory, the row count from the release preview attachment, and the licence text from the metadata XML in the zip. - Instructions: Cheap version check before or after a records_list run; publication_id changes with each release upload. - Cost: 5 credits per call - Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/data-transportation-gov/addresses/source_status) Accepted options: Response schema example: ```json { "files": [ { "asset_id": "fc2s-wawr", "etag": "\"596a301b-d548-4589-8c63-6b6a8dc34f30--gzip\"", "filename": "TXT.zip", "landing_url": "https://data.transportation.gov/d/fc2s-wawr", "mime_type": "application/x-zip-compressed", "name": "National Address Database (NAD) Text File", "publication_date": "2025-09-24T19:19:54Z", "size_bytes": 8477543836, "url": "https://data.transportation.gov/api/views/fc2s-wawr/files/596a301b-d548-4589-8c63-6b6a8dc34f30?download=true&filename=TXT.zip", "view_last_modified_at": "2026-09-30T21:19:22Z" }, { "asset_id": "yw36-suxr", "etag": "\"b26fdf7f-982c-40c9-a477-7d9d835b43ed--gzip\"", "filename": "NAD_r24.gdb.zip", "landing_url": "https://data.transportation.gov/d/yw36-suxr", "mime_type": "application/x-zip-compressed", "name": "National Address Database (NAD) File Geodatabase", "publication_date": "2025-09-24T17:20:09Z", "size_bytes": 10949783397, "url": "https://data.transportation.gov/api/views/yw36-suxr/files/b26fdf7f-982c-40c9-a477-7d9d835b43ed?download=true&filename=NAD_r24.gdb.zip", "view_last_modified_at": "2026-09-30T21:22:40Z" } ], "hand_off": { "reason": "records_list pages TXT/NAD_r24.txt (42.1 GB of CSV) in file order straight from TXT.zip with byte-range reads. A full load is faster from the zip URLs above (8.5 GB TXT, 10.9 GB File Geodatabase).", "required": false }, "license": "Published data made available as a part of the NAD is provided as a public service to enhance open government, transparency, and accountability. The NAD is a compilation of data provided by state, local, and tribal governments and is made available \"as is.\" Although the NAD is open data, it is not intended for use as a mailing list and is subject to individual state statutes that prohibit its use as a mailing list. The NAD is a work of the federal government and as such is not subject to copyright protection in accordance with 17 U.S.C. ยง 105. It is available for re-use without limitation or restriction.", "observed_at_ms": 1792889963824, "publication_id": "files:r24:596a301b-d548-4589-8c63-6b6a8dc34f30", "release": { "compiled_on": "2026-09-30", "description": "The Address Points from National Address Database dataset was compiled on September 30, 2026 by the US Department of Transportation. The National Address Database (NAD) is a spatial database containing address data, point location coordinates, jurisdictions, record-level metadata and other supporting data for addressable locations including structures, some sub-units within those structures, and landmarks as included in the aggregated datasets from providers included therein.\n\nTechnical Note: Record Ordering and Object IDs\nPlease Note: The records in this flat text file are structured in their optimized physical database order, rather than numerical sequence by OID_ (Object ID). Because the National Address Database leverages highly efficient spatial indexing and bit-packing compression algorithms before export, geographically clustered records (such as specific states or counties) are grouped together on disk.\n\nAll OID_ values remain perfectly unique across the entire dataset, but they will appear out of chronological order when reading the file sequentially. If your integration workflow requires a strict numerical sequence, you can safely sort the dataset by the OID_ column upon ingestion.", "id": "r24", "number": 24, "published_at": "2026-09-30T21:22:40Z" }, "row_count": 99226272, "row_count_source": "NAD_r24_SAMPLE_First_and_Last_20_lines.txt", "txt_member": { "compressed_bytes": 8477533188, "compression": "deflate64", "crc32": "7ac85a5b", "data_offset": 10388, "name": "TXT/NAD_r24.txt", "uncompressed_bytes": 42111724256 } } ```