Socrata Discovery API
api.us.socrata.com
A federated catalogue of the open-data assets published across thousands of Socrata / Tyler Data & Insights government portals, searchable by keyword, portal, category, tag, owner, licence or asset ID, and returning each asset's full column schema, update history, popularity and permalink.
GET /v1/data/socrata/asset-metadata1Request
Comma-separated Socrata four-by-four asset IDs (the xxxx-xxxx code in a dataset URL).
Number of results per page. The upstream default is 100 and the maximum is 10000.
Number of results to skip, for paging.
curl "https://api.fastcrw.com/v1/data/socrata/asset-metadata?ids=ijzp-q8t2&limit=20&offset=0" \ -H "Authorization: Bearer $FASTCRW_API_KEY"
2Response example
A sample shape. Press Run to see live data from Socrata Discovery API.
| resource | classification | metadata | permalink | link | owner | creator |
|---|---|---|---|---|---|---|
| {"name":"Crimes - 2001 to Present","id":"ijzp-q8t2","resource_name":"crimes","parent_fxf":[],"description":"This dataset reflects reported incidents of crime (with the exception of murders where data exists for each victim) that occurred in the City of Chicago from 2001 to present, minus the most recent seven days. Data is extracted from the Chicago Police Department's CLEAR (Citizen Law Enforcement Analysis and Reporting) system. In order to protect the privacy of crime victims, addresses are shown at the block level only and specific locations are not identified. Should you have questions about this dataset, you may contact the Data Fulfillment and Analysis Division of the Chicago Police Department at DFA@ChicagoPolice.org. Disclaimer: These crimes may be based upon preliminary information supplied to the Police Department by the reporting parties that have not been verified. The preliminary crime classifications may be changed at a later date based upon additional investigation and there is always the possibility of mechanical or human error. Therefore, the Chicago Police Department does not guarantee (either expressed or implied) the accuracy, completeness, timeliness, or correct sequencing of the information and the information should not be used for comparison purposes over time. The Chicago Police Department will not be responsible for any error or omission, or for the use of, or the results obtained from the use of this information. All data visualizations on maps should be considered approximate and attempts to derive specific addresses are strictly prohibited. The Chicago Police Department is not responsible for the content of any off-site pages that are referenced by or that reference this web page other than an official City of Chicago or Chicago Police Department web page. The user specifically acknowledges that the Chicago Police Department is not responsible for any defamatory, offensive, misleading, or illegal conduct of other users, links, or third parties and that the risk of injury from the foregoing rests entirely with the user. The unauthorized use …","attribution":"Chicago Police Department","attribution_link":"https://www.chicagopolice.org/data-statistics/","contact_email":null,"type":"dataset","updatedAt":"2026-10-21T10:53:28.000Z","createdAt":"2011-09-30T17:59:31.000Z","metadata_updated_at":"2026-09-08T18:32:36.000Z","data_updated_at":"2026-10-21T10:53:28.000Z","page_views":{"page_views_last_week":3624,"page_views_last_month":13747,"page_views_total":1333472,"page_views_last_week_log":11.82376527978966,"page_views_last_month_log":13.746934136372296,"page_views_total_log":20.346757182994075},"columns_name":["Location (state)","Zip Codes","Historical Wards 2003-2015","Wards","Boundaries - ZIP Codes","Police Districts","Police Beats","Location Description","Community Area","Community Areas","… 25 more items"],"columns_field_name":["location_state",":@computed_region_6mkv_f3dw",":@computed_region_awaf_s7ux",":@computed_region_43wa_7qmu",":@computed_region_rpca_8um6",":@computed_region_d9mm_jgwp",":@computed_region_d3ds_rm58","location_description","community_area",":@computed_region_vrxf_vc4k","… 25 more items"],"columns_datatype":["Text","Number","Number","Number","Number","Number","Number","Text","Text","Number","… 25 more items"],"columns_description":["","","","","","","","Description of the location where the incident occurred.","Indicates the community area where the incident occurred. Chicago has 77 community areas. \n\nSee the community areas at https://data.cityofchicago.org/d/cauq-8yn6.\n","","… 25 more items"],"columns_format":[{},{},{},{},{},{},{},{"displayStyle":"plain","align":"left"},{"displayStyle":"plain","align":"left"},{},"… 25 more items"],"download_count":927995,"provenance":"official","lens_view_type":"tabular","lens_display_type":"table","locked":false,"backend":"nbe","blob_mime_type":null,"hide_from_data_json":false,"publication_date":"2023-09-15T03:58:21.000Z"} | {"categories":[],"tags":[],"domain_category":"Public Safety","domain_tags":["crime","police"],"domain_metadata":[{"key":"Metadata_Frequency","value":"Data are updated daily."},{"key":"Metadata_Data-Owner","value":"Police"},{"key":"Metadata_Time-Period","value":"2001 to present, minus the most recent seven days"},{"key":"Metadata_Changes-and-Other-Historical-Information-Useful-to-Understanding-This-Dataset","value":"https://www.google.com/search?q=site:data.cityofchicago.org/stories+\"Related+dataset+ID+s\"+\"ijzp-q8t2\""}]} | {"domain":"data.cityofchicago.org","license":"See Terms of Use"} | https://data.cityofchicago.org/d/ijzp-q8t2 | https://data.cityofchicago.org/Public-Safety/Crimes-2001-to-Present/ijzp-q8t2 | {"id":"scy9-9wg4","user_type":"interactive","display_name":"cocadmin"} | {"id":"scy9-9wg4","user_type":"interactive","display_name":"cocadmin"} |
Attribution: Metadata from the Socrata Discovery API (Tyler Technologies, Data & Insights). Each record remains subject to the licence and terms of use of the portal that publishes it.
Licence: No blanket licence covers this catalogue. The Discovery API federates metadata from thousands of independently operated Socrata / Tyler Data & Insights portals and the terms are per-record: every result carries its own "metadata": {"license": ...} string set by the publishing agency. Values seen in live responses (2026-10-22) include "See Terms of Use" (e.g. data.cityofchicago.org/ijzp-q8t2), "Public Domain" and null; they are not interchangeable and none of them governs the catalogue as a whole. The only written reuse statement the operator publishes is the footer of its developer documentation site, and it is non-commercial: dev.socrata.com reads verbatim "Licensed by Tyler Technologies under CC BY-NC-SA 3.0.", with rel="license" pointing at http://creativecommons.org/licenses/by-nc-sa/3.0/deed.en_US. That covers the documentation site, not the data, and nothing on dev.socrata.com or tylertech.com grants commercial reuse or redistribution of catalogue metadata. commercialUse and redistribution are therefore both false: we pass the metadata through claiming nothing, and each record's own license field plus the linked portal's terms of use are what actually govern reuse of the asset behind it.
Ask with this source
A prompt for your agent that names this source and how to call it through the crw MCP.
Asset metadata by ID
Use Socrata Discovery API (socrata) from fastCRW Pergamon, capability "Asset metadata by ID" (asset-metadata). You already hold a Socrata four-by-four ID and want that asset's schema and metadata rather than its rows. Example options: ids=ijzp-q8t2, limit=20, offset=0. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "socrata" and capability "asset-metadata". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Assets with an exact title
Use Socrata Discovery API (socrata) from fastCRW Pergamon, capability "Assets with an exact title" (assets-by-name). You know the exact dataset title and want every portal that publishes one by that name. Example options: names=Building Permits, domains=data.cityofchicago.org, only=dataset. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "socrata" and capability "assets-by-name". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Assets by attributed source
Use Socrata Discovery API (socrata) from fastCRW Pergamon, capability "Assets by attributed source" (attribution-assets). You want everything credited to one agency or organisation, including assets republished on other portals. Example options: attribution=City of Chicago, domains=data.cityofchicago.org, q=crime. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "socrata" and capability "attribution-assets". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Title autocomplete
Use Socrata Discovery API (socrata) from fastCRW Pergamon, capability "Title autocomplete" (autocomplete). You are completing a user's half-typed dataset name and want suggestions rather than full records. Example options: q=crime, domains=data.cityofchicago.org, search_context=data.cityofchicago.org. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "socrata" and capability "autocomplete". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>