Product
Introducing Socket Fix for Safe, Automated Dependency Upgrades
Automatically fix and test dependency updates with socket fix—a new CLI tool that turns CVE alerts into safe, automated upgrades.
By John-David Dalton - Apr 25, 2025
🚀 Socket Launch Week 🚀 Day 5: Introducing Socket Fix.Learn More →
acre-api
An unofficial NodeJS API for retrieving property data from the Allegheny County Real Estate web service. ## Getting Started
The Unofficial Allegheny County Real Estate API
An unofficial NodeJS API for retrieving property data from the Allegheny County Real Estate web service.
Getting Started
npm install acre-api
Then use the API by requiring it:
var acreApi = require('acre-api');
acreApi.street.street('Liberty', 'Pittsburgh - All Wards', function(err, parcels) {
if(err) {
console.log(err);
} else {
// Prints a list of houses on the street
console.log(parcels);
}
});
search(houseNumber, streetName, errback)
Search for a parcel at a number and street
acreApi.search(1000, 'Liberty', function(err, parcel) {
if(err) {
console.log(err);
} else {
// Logs generalInfo for parcel
console.log(parcel);
}
});
Parcel
All parcel methods require a parcel ID
generalInfo(parcelId, errback)
Returns general information about a parcel.
acreApi.parcel.generalInfo('0009-P-00150-0000-00', function(err, parcel) {
if(err) {
console.log(err);
} else {
console.log(parcel);
}
});
// Outputs
{
parcelId: '0009-P-00150-0000-00',
municipality: '102 PITTSBURGH - 2ND WARD',
address: '1000 LIBERTY AVEPITTSBURGH, PA 15222',
ownerName: 'UNITED STATES OF AMERICA',
school: 'City Of Pittsburgh',
taxCode: 'Exempt',
ownerCode: 'Corporation',
stateCode: 'Government',
useCode: 'FEDERAL GOVERNMENT',
homestead: 'No',
farmstead: 'No',
neighborhoodCode: '51C01',
recordingDate: -316897200000,
salePrice: 0,
deedBook: '',
deedPage: '0',
abatement: 'No',
lotArea: 2,
fullMarketValues: {
2015: {
landValue: 7063200,
buildingValue: 94595700,
totalValue: 101658900
},
2014: {
landValue: 7063200,
buildingValue: 94595700,
totalValue: 101658900
}
},
countyAssessedValues: {
2015: {
landValue: 7063200,
buildingValue: 94595700,
totalValue: 101658900
},
2014: {
landValue: 7063200,
buildingValue: 94595700,
totalValue: 101658900
}
}
};
buildingInfo(parcelId, errback)
Gets information about the structure on the parcel, if any.
acreApi.parcel.buildingInfo('0084-N-00285-0000-00', function(err, parcel) {
if(err) {
console.log(err);
} else {
console.log(parcel);
}
});
// Outputs
{
parcelId: '0084-N-00285-0000-00',
municipality: '107 PITTSBURGH - 7TH WARD',
address: '5801 WALNUT ST PITTSBURGH, PA 15232',
ownerName: 'BORETSKY ROBERT H & KAREN R (W)',
useType: 'THREE FAMILY',
totalRooms: 12,
basement: 'Full Basement',
style: 'MULTI-FAMILY',
bedrooms: 6,
grade: 'C+',
stories: 2,
fullBaths: 3,
condition: 'Average',
yearBuilt: '1900',
halfBaths: 0,
fireplaces: 0,
exterior: 'Brick',
heat: 'Central Heat',
garages: 0,
roof: 'Shingle',
cooling: '',
livableSquareFeet: 3362
}
taxInfo(parcelId, errback)
Gets tax information about the parcel.
acreApi.parcel.taxInfo('0084-N-00285-0000-00', function(err, parcel) {
if(err) {
console.log(err);
} else {
console.log(parcel);
}
});
// Outputs
{
parcelId: '0084-N-00285-0000-00',
municipality: '107 PITTSBURGH - 7TH WARD',
address: '5801 WALNUT ST PITTSBURGH, PA 15232',
ownerName: 'BORETSKY ROBERT H & KAREN R (W)',
taxBillAddr: 'EQUITY REAL ESTATE2029 MURRAY AVEPITTSBURGH PA15217',
netTaxDueThisMonth: 1251.56,
grossTaxDueNextMonth: 1277.1,
taxValue: 270000,
millageRate: 4.73,
taxHistory: {
'2012': {
paidStatus: 'PAID',
tax: 978.07,
penalty: 0,
interest: 0,
total: 978.07,
datePaid: '5/21/2012'
},
'2013': {
paidStatus: 'PAID',
tax: 1251.56,
penalty: 0,
interest: 0,
total: 1251.56,
datePaid: '4/15/2013'
},
'2014': {
paidStatus: 'PAID',
tax: 1251.56,
penalty: 0,
interest: 0,
total: 1251.56,
datePaid: '3/10/2014'
},
'2015': {
paidStatus: 'UNPAID',
tax: 1251.56,
penalty: 0,
interest: 0,
total: 1251.56,
datePaid: '3/31/2015'
}
}
}
ownerHistory(parcelId, errback)
Gets information about the ownership history of the parcel.
acreApi.parcel.ownerHistory(parcelId, function(err, parcel) {
if(err) {
console.log(err);
} else {
console.log(parcel);
}
});
// Outputs
{
parcelId: '0084-N-00285-0000-00',
municipality: '107 PITTSBURGH - 7TH WARD',
address: '5801 WALNUT ST PITTSBURGH, PA 15232',
ownerName: 'BORETSKY ROBERT H & KAREN R (W)',
deedBook: '10857',
deedPage: '371',
ownerHistory: [{
owner: '',
saleDate: '',
salePrice: 1
}, {
owner: 'ANN MEDIS',
saleDate: '2/8/1993',
salePrice: 33000
}, {
owner: 'BORETSKY ROBERT H & KAREN R (W)',
saleDate: '9/1/2000',
salePrice: 125000
}]
}
image(parcelId, errback)
Gets a link to the exterior photo on file.
acreApi.parcel.image(parcelId, function(err, parcel) {
if(err) {
console.log(err);
} else {
console.log(parcel);
}
});
// Outputs
{
parcelId: '0084-N-00285-0000-00',
municipality: '107 PITTSBURGH - 7TH WARD',
address: '5801 WALNUT ST PITTSBURGH, PA 15232',
ownerName: 'BORETSKY ROBERT H & KAREN R (W)',
image: 'http://photos.county.allegheny.pa.us/iasworld/iDoc2/Services/GetPhoto.ashx?parid=0084N00285000000&jur=002&Rank=1&size=350x263'
}
comps(parcelId, errback)
Gets back information about comparable parcels.
acreApi.parcel.comps(parcelId, function(err, parcel) {
if(err) {
console.log(err);
} else {
console.log(parcel);
}
});
// Outputs
{
parcelId: '0084-N-00285-0000-00',
municipality: '107 PITTSBURGH - 7TH WARD',
address: '5801 WALNUT ST PITTSBURGH, PA 15232',
ownerName: 'BORETSKY ROBERT H & KAREN R (W)',
comps: [{
address: '5801 WALNUT ST',
yearBuilt: '1900',
parcelId: '0084N00285000000',
salePrice: 190000,
saleDate: '9/1/2000',
livableSquareFeet: 3362,
landValue: 178200,
bldgValue: 150500,
totalValue: 328700
}, {
address: '5735 HOWE ST',
yearBuilt: '1900',
parcelId: '0085A00281000000',
salePrice: 372500,
saleDate: '7/23/2010',
livableSquareFeet: 2710,
landValue: 182800,
bldgValue: 157800,
totalValue: 340600
}, {
address: '611 S AIKEN AVE',
yearBuilt: '1919',
parcelId: '0052D00118000000',
salePrice: 260000,
saleDate: '12/22/2008',
livableSquareFeet: 2614,
landValue: 146000,
bldgValue: 135400,
totalValue: 281400
}, {
address: '5536 KENTUCKY AVE',
yearBuilt: '1900',
parcelId: '0085E00038000000',
salePrice: 380000,
saleDate: '5/27/2009',
livableSquareFeet: 2554,
landValue: 150000,
bldgValue: 188700,
totalValue: 338700
}, {
address: '5529 HOWE ST',
yearBuilt: '1910',
parcelId: '0085A00018000000',
salePrice: 215000,
saleDate: '7/27/2009',
livableSquareFeet: 2418,
landValue: 149600,
bldgValue: 64000,
totalValue: 213600
}]
}
Street
These methods are for retrieving lots of parcels.
street(streetName, municipality, errback)
Returns top-level information on all of the parcels on a given street within a given municipality. streetName can match many street names.
acreApi.street.street('Liberty', 'Pittsburgh - All Wards', function(err, parcels) {
if(err) {
console.log(err);
} else {
console.log(parcels);
}
});
// Outputs
[{
parcel_id: '0001-F-00048-0000-00',
owner_name: 'COMMONWEALTH OF PENNSYLVANIA',
address: 'LIBERTY AVE',
municipality: 'PITTSBURGH - 1ST WARD',
vacant: 'Yes'
},{
parcel_id: '0001-F-00020-0000-00',
owner_name: 'COMMONWEALTH OF PENNSYLVANIA',
address: 'LIBERTY AVE',
municipality: 'PITTSBURGH - 1ST WARD',
vacant: 'no'
},{
parcel_id: '0001-C-00200-0000-00',
owner_name: 'HERTZ GATEWAY CENTER LP',
address: 'LIBERTY AVE',
municipality: 'PITTSBURGH - 1ST WARD',
vacant: 'no'
},{
parcel_id: '0001-C-00200-0000-01',
owner_name: 'PORT AUTHORITY OF ALLEGHENY COUNTY',
address: 'LIBERTY AVE',
municipality: 'PITTSBURGH - 1ST WARD',
vacant: 'no'
},{
// ...
}]
block(blockNumber, streetName, errback)
Gets all of the parcels on a given block - streetName can match many street names.
acreApi.street.block(1000, 'Liberty', function(err, parcels) {
if(err) {
console.log(err);
} else {
console.log(parcels);
}
});
// Outputs
[{
parcelId: '0009-P-00150-0000-00',
municipality: '102 PITTSBURGH - 2ND WARD',
address: '1000 LIBERTY AVE PITTSBURGH, PA 15222',
ownerName: 'UNITED STATES OF AMERICA',
school: 'City Of Pittsburgh',
taxCode: 'Exempt',
ownerCode: 'Corporation',
stateCode: 'Government',
useCode: 'FEDERAL GOVERNMENT',
homestead: 'No',
farmstead: 'No',
neighborhoodCode: '51C01',
recordingDate: '12/17/1959',
salePrice: 0,
deedBook: '',
deedPage: '0',
abatement: 'No',
lotArea: 2,
fullMarketValues: {
2015: {
landValue: 7063200,
buildingValue: 94595700,
totalValue: 101658900
},
2014: {
landValue: 7063200,
buildingValue: 94595700,
totalValue: 101658900
}
},
countyAssessedValues: {
2015: {
landValue: 7063200,
buildingValue: 94595700,
totalValue: 101658900
},
2014: {
landValue: 7063200,
buildingValue: 94595700,
totalValue: 101658900
}
},
},{
parcelId: '0009-P-00050-0000-00',
municipality: '102 PITTSBURGH - 2ND WARD',
address: '1001 LIBERTY AVE PITTSBURGH, PA 15222',
ownerName: 'IX LIBERTY CENTER OWNER LP',
school: 'City Of Pittsburgh',
taxCode: 'Taxable',
ownerCode: 'Corporation',
stateCode: 'Commercial',
useCode: 'HOTELS',
homestead: 'No',
farmstead: 'No',
neighborhoodCode: '51C01',
recordingDate: '8/9/2013',
salePrice: 124400000,
deedBook: '15334',
deedPage: '322',
abatement: 'No',
lotArea: 2,
fullMarketValues: {
2015: {
landValue: 12000000,
buildingValue: 111500000,
totalValue: 123500000
},
2014: {
landValue: 12000000,
buildingValue: 111500000,
totalValue: 123500000
}
},
countyAssessedValues: {
2015: {
landValue: 12000000,
buildingValue: 111500000,
totalValue: 123500000
},
2014: {
landValue: 12000000,
buildingValue: 111500000,
totalValue: 123500000
}
},
},{
// ...
}]
Municipalities
Methods for finding municipal codes.
search(municipality)
Returns the municipal code for a given municipal name, if any.
var muniId = acreApi.municipality.search('Pittsburgh - All Wards');
console.log(muniId);
// Outputs
1
all()
Returns all of the municipalities
var muniIndex = acreApi.municipality.all();
console.log(muniIndex);
// Outputs
{
'Aleppo': 901,
'Aspinwall': 801,
'Avalon': 802,
'Baldwin Boro': 877,
...
}
Acknowledgements
The Allegheny County Real Estate API is maintained by Dan Wilkerson and is in no way associated with the government of Allegheny County, its affiliates, or its subsidiaries.
©2015 Dan Wilkerson under the MIT License.
FAQs
An unofficial NodeJS API for retrieving property data from the Allegheny County Real Estate web service. ## Getting Started
The npm package acre-api receives a total of 4 weekly downloads. As such, acre-api popularity was classified as not popular.
We found that acre-api demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Package last updated on 08 Nov 2022
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Related posts
Security News
CISA Rebuffs Funding Concerns as CVE Foundation Draws Criticism
CISA denies CVE funding issues amid backlash over a new CVE foundation formed by board members, raising concerns about transparency and program governance.
By Sarah Gooding - Apr 24, 2025
Product
Introducing Historical Analytics – Now in Beta
We’re excited to announce a powerful new capability in Socket: historical data and enhanced analytics.
By Phil Gates-Idem - Apr 24, 2025