{"contractVersion":"parcelops.connector.v1","name":"census-acs","displayName":"Census Housing & Business Context","description":"ACS housing estimates plus County Business Patterns establishment, employment, and payroll context.","tags":["housing","commercial-real-estate","market-context","acs","cbp","census","united-states","bring-your-own-key"],"authentication":{"type":"api_key","required":true},"provenance":{"sourceName":"US Census Bureau ACS and County Business Patterns","sourceUrl":"https://api.census.gov/data","apiBaseUrl":"https://api.census.gov/data","documentationUrl":"https://www.census.gov/data/developers/data-sets.html"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Supports ACS 5-year vintages from 2019 through 2024 and the latest verified CBP vintage, 2023."}},"coverage":{"geographic":{"status":"declared","value":["United States","District of Columbia","Puerto Rico"]},"temporal":{"status":"not_declared"}},"methods":{"total":4,"items":[{"name":"getHousingProfile","description":"Get ACS housing estimates and margins of error for one exact geography.","requiredParams":["geography"],"inputSchema":{"type":"object","properties":{"geography":{"type":"string","enum":["state","county","tract","place","zip"]},"stateFips":{"type":"string","pattern":"^\\d{2}$"},"countyFips":{"type":"string","pattern":"^\\d{3}$"},"tract":{"type":"string","pattern":"^\\d{6}$"},"placeFips":{"type":"string","pattern":"^\\d{5}$"},"zipCode":{"type":"string","pattern":"^\\d{5}$"},"year":{"type":"integer","minimum":2019,"maximum":2024}},"required":["geography"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Supports ACS 5-year vintages from 2019 through 2024 and the latest verified CBP vintage, 2023."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Area-level survey estimates are not facts about a parcel, building, household, tenant, or transaction.","County Business Patterns is county industry context, not property occupancy, vacancy, rent, or transaction data.","Do not use this context to rank neighborhood quality or make protected-class decisions."]},{"name":"compareHousingAreas","description":"Compare ACS housing profiles for two to ten exact geographies.","requiredParams":["areas"],"inputSchema":{"type":"object","properties":{"areas":{"type":"array","minItems":2,"maxItems":10,"items":{"type":"object","properties":{"geography":{"type":"string","enum":["state","county","tract","place","zip"]},"stateFips":{"type":"string","pattern":"^\\d{2}$"},"countyFips":{"type":"string","pattern":"^\\d{3}$"},"tract":{"type":"string","pattern":"^\\d{6}$"},"placeFips":{"type":"string","pattern":"^\\d{5}$"},"zipCode":{"type":"string","pattern":"^\\d{5}$"},"year":{"type":"integer","minimum":2019,"maximum":2024}},"required":["geography"],"additionalProperties":false}}},"required":["areas"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Supports ACS 5-year vintages from 2019 through 2024 and the latest verified CBP vintage, 2023."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Area-level survey estimates are not facts about a parcel, building, household, tenant, or transaction.","County Business Patterns is county industry context, not property occupancy, vacancy, rent, or transaction data.","Do not use this context to rank neighborhood quality or make protected-class decisions."]},{"name":"getCountyBusinessProfile","description":"Get paid-employee establishments, employment, and payroll for one county and NAICS code.","requiredParams":["stateFips","countyFips","naics2017"],"inputSchema":{"type":"object","properties":{"stateFips":{"type":"string","pattern":"^\\d{2}$"},"countyFips":{"type":"string","pattern":"^\\d{3}$"},"naics2017":{"type":"string","pattern":"^(?:00|\\d{2,6})$","description":"Exact 2017 NAICS code, or 00 for all sectors."}},"required":["stateFips","countyFips","naics2017"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Supports ACS 5-year vintages from 2019 through 2024 and the latest verified CBP vintage, 2023."},"scope":"connector"},"entities":{"status":"declared","value":["county-industry-profile"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Area-level survey estimates are not facts about a parcel, building, household, tenant, or transaction.","County Business Patterns is county industry context, not property occupancy, vacancy, rent, or transaction data.","Do not use this context to rank neighborhood quality or make protected-class decisions.","Industry-demand context only; not property occupancy, vacancy, rent, or transaction data."]},{"name":"getServiceInfo","description":"Return datasets, variables, vintages, coverage, and use limits.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","notes":"Supports ACS 5-year vintages from 2019 through 2024 and the latest verified CBP vintage, 2023."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Area-level survey estimates are not facts about a parcel, building, household, tenant, or transaction.","County Business Patterns is county industry context, not property occupancy, vacancy, rent, or transaction data.","Do not use this context to rank neighborhood quality or make protected-class decisions."]}]},"caveats":["Area-level survey estimates are not facts about a parcel, building, household, tenant, or transaction.","County Business Patterns is county industry context, not property occupancy, vacancy, rent, or transaction data.","Do not use this context to rank neighborhood quality or make protected-class decisions."]}