{"contractVersion":"parcelops.connector.v1","name":"socrata-discovery","displayName":"US Municipal Open Data Discovery","description":"Federated discovery and bounded querying of real-estate datasets across participating US Socrata portals, plus curated city building-permit feeds on ArcGIS, CKAN, Carto, and OpenDataSoft.","tags":["open-data","socrata","municipal","zoning","permits","assessments","code-enforcement","building-permits","inspections","property-timeline","united-states"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"Socrata US Open Data Catalog and participating municipal portals","sourceUrl":"https://api.us.socrata.com/api/catalog/v1","apiBaseUrl":"https://api.us.socrata.com/api/catalog/v1","documentationUrl":"https://dev.socrata.com/consumers/getting-started"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."}},"coverage":{"geographic":{"status":"declared","value":["United States, where a participating publisher exposes a Socrata dataset"]},"temporal":{"status":"not_declared"}},"methods":{"total":8,"items":[{"name":"searchDatasets","description":"Find municipal real-estate datasets in the US Socrata catalog.","requiredParams":["q"],"inputSchema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":200},"portal":{"type":"string","maxLength":253,"description":"Optional exact portal hostname without scheme, path, or port."},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["q"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."},"scope":"connector"},"entities":{"status":"declared","value":["open-data-dataset"]},"pagination":{"status":"declared","value":{"style":"none","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history.","Catalog resultSetSize is discovery metadata, not a claim that every record is queryable."]},{"name":"getDatasetSchema","description":"Inspect one catalog-verified Socrata dataset’s portal-specific columns and published license.","requiredParams":["portal","datasetId"],"inputSchema":{"type":"object","properties":{"portal":{"type":"string","minLength":3,"maxLength":253},"datasetId":{"type":"string","pattern":"^[A-Za-z0-9]{4}-[A-Za-z0-9]{4}$"}},"required":["portal","datasetId"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history."]},{"name":"queryDataset","description":"Query one catalog-verified dataset with structured fields and filters; raw SoQL is not accepted.","requiredParams":["portal","datasetId"],"inputSchema":{"type":"object","properties":{"portal":{"type":"string","minLength":3,"maxLength":253},"datasetId":{"type":"string","pattern":"^[A-Za-z0-9]{4}-[A-Za-z0-9]{4}$"},"fields":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","pattern":"^:?[A-Za-z_][A-Za-z0-9_]*$"}},"filters":{"type":"array","maxItems":10,"items":{"type":"object","properties":{"field":{"type":"string","pattern":"^:?[A-Za-z_][A-Za-z0-9_]*$"},"operator":{"type":"string","enum":["eq","neq","gt","gte","lt","lte","contains","startsWith"]},"value":{"oneOf":[{"type":"string","maxLength":500},{"type":"number"},{"type":"boolean"},{"type":"null"}]}},"required":["field","operator","value"],"additionalProperties":false}},"orderBy":{"type":"object","properties":{"field":{"type":"string","pattern":"^:?[A-Za-z_][A-Za-z0-9_]*$"},"direction":{"type":"string","enum":["asc","desc"]}},"required":["field"],"additionalProperties":false},"fullText":{"type":"string","minLength":1,"maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":1000},"offset":{"type":"integer","minimum":0,"maximum":100000}},"required":["portal","datasetId"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."},"scope":"connector"},"entities":{"status":"declared","value":["portal-specific-open-data-row"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history.","Rows retain the upstream portal schema; no cross-city field normalization is implied."]},{"name":"listMunicipalBuildingOperationsSources","description":"List curated city permit, inspection, and violation feeds for the normalized workflow.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."},"scope":"connector"},"entities":{"status":"declared","value":["municipal-building-operations-source"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history.","Coverage, history, update cadence, and reuse terms differ by city and source feed."]},{"name":"queryMunicipalBuildingOperations","description":"Search normalized permits, inspections, or violations for one curated city and property phrase.","requiredParams":["market","propertySearch"],"inputSchema":{"type":"object","properties":{"market":{"type":"string","enum":["chicago","seattle","austin","san-francisco","los-angeles"]},"propertySearch":{"type":"string","minLength":2,"maxLength":200,"description":"Address, parcel identifier, or other property phrase supported by the selected municipal feed."},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0,"maximum":100000}},"required":["market","propertySearch"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."},"scope":"connector"},"entities":{"status":"declared","value":["building-permit","building-inspection","property-violation"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history.","Normalized public events are screening context, not proof of present permit, inspection, or code status.","ParcelOps excludes personal and contractor contact fields."]},{"name":"listNewConstructionPermitSources","description":"List curated new-construction permit sources with live-verified compound filter recipes.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."},"scope":"connector"},"entities":{"status":"declared","value":["new-construction-permit-source"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history.","Recipes were verified live on the listed date; portals can rename fields or freeze datasets afterward.","Sources cover the listed jurisdictions only and record different construction-timeline stages."]},{"name":"queryNewConstructionPermits","description":"Query one curated source with its verified new-residential-construction recipe applied server-side.","requiredParams":["sourceId"],"inputSchema":{"type":"object","properties":{"sourceId":{"type":"string","enum":["chicago-new-construction","seattle-new-residential","marin-county-new-residential","baton-rouge-new-residential","cincinnati-new-single-family","cincinnati-new-multifamily","mesa-new-residential","austin-new-residential-construction","austin-new-residential-building","los-angeles-new-residential-applications","los-angeles-new-residential-completions","cambridge-new-residential","honolulu-new-residential-historical","norfolk-new-residential","pierce-county-new-residential","new-jersey-new-residential","san-francisco-new-residential","nyc-new-building-permits","nyc-new-building-completions","philadelphia-new-residential","san-antonio-new-residential","san-jose-new-residential","boston-new-residential","milwaukee-new-residential","columbus-new-residential","charlotte-new-residential","nashville-new-residential","el-paso-new-residential","louisville-new-residential","detroit-new-residential","sacramento-new-residential","raleigh-new-residential","virginia-beach-new-residential","minneapolis-new-residential","memphis-new-residential","new-orleans-new-residential","plano-new-residential","orlando-new-residential","cleveland-new-residential","greensboro-new-residential","pittsburgh-new-residential","durham-new-residential","scottsdale-new-residential","gilbert-new-residential","winston-salem-new-residential","buffalo-new-residential","kansas-city-new-residential","portland-new-residential","chesapeake-new-residential-projects","dfw-nctcog-new-residential-projects","california-hcd-apr-new-residential"]},"issuedAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"ISO date lower bound; only accepted for sources whose listing reports supportsIssuedAfter."},"limit":{"type":"integer","minimum":1,"maximum":1000},"offset":{"type":"integer","minimum":0,"maximum":100000}},"required":["sourceId"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."},"scope":"connector"},"entities":{"status":"declared","value":["building-permit"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history.","Rows retain the upstream portal schema; no cross-city normalization is implied.","A permit or certificate record is screening context, not proof construction started or finished."]},{"name":"getServiceInfo","description":"Return the discovery workflow, security controls, limits, auth option, and license caveats.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","updatedAtField":"source.updatedAt","notes":"Each portal and dataset publishes on its own cadence."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history."]}]},"caveats":["Schemas, publishers, update practices, licenses, and attribution requirements vary by dataset.","A catalog record may describe a viewer or download rather than a stable tabular API.","Municipal free text is treated as untrusted data and passes through ParcelOps response scanning.","Curated building-operations workflows normalize a small fixed set of city feeds; they are not a complete national permit, inspection, or violation history."]}