Scout provides an API for users to look up contacts based on different input parameters (Name, Address, Location, or Email Address).

When passing these parameters, Scout will return information on those individuals including demographic data, property information, and contact information (phones and emails).

Please note that Scout uses 2 different API end-points for individual lookups and batch lookups (csv).

How to Create an API Key in Scout

You can create an API Key in Scout in the Profile Page by navigating to the API Keys tab.

https://www.loom.com/share/bd4db850aab04a58b66d48227db9c5cb

API Documentation

You can access Scout’s API Key documentation here.

Response Definitions

Scout provides a limited number of response fields in our standard API. Please review the fields below for reference.

Field Type Description
matched_first_name string The exact first name found in the data, which may differ from input after nickname/normalization.
matched_middle_name string The exact middle name found in the data.
matched_last_name string The exact last name found in the data.
address string The Full Address components, including House Number, Directional, Street Name, etc.
city string City Name as listed in USPS Publication 26.
zip_code string The five-position numeric Zip Code.
county string The county name corresponding to the address.
state string The two-position alpha FIPS State code (e.g., IL, NY).
age integer Estimated Age (18-99), calculated from date of birth data.
match_score number A numeric score (0–100). Higher = better.
email1...email5 string Up to five email addresses associated with the record.
email_confidence1...5 string Confidence level for the corresponding email address. Codes are H (High), M (Medium).
phone1...phone3 string Up to three public directory assistance and household-based phone numbers (10 digits).
first_name, middle_name, last_name string These fields contain the input values from your request (for reference).
suffix string The generational suffix of the individual (e.g., JR, SR).
gender string The gender of an individual. Codes: M (Male), F (Female).
vacant string Designation by USPS of a vacant property. Codes: Y (Vacant), N (Occupied).
latitude float The geometrical location north or south of the equator (decimal degrees).
longitude float The geometrical location east or west of the prime meridian (decimal degrees).
lor integer Length of Residence (00-15 years) at the current address.
homeownercd string Homeowner and renter status. Codes: H (Homeowner), R (Renter), O (Probable Homeowner), P (Probable Renter), U (Unknown).
dwelltype string Dwelling Type. Codes: S (Single Family), M (Multi Family).
marriedcd string Marital Status. Codes: M (Married), S (Single).
veterancd string Compilation of signals indicating a Veteran in Household. Code: Y (Yes).
occupation string Deprecated. Placeholder for the new occupation code (OCCUPATIONCD_V2).
child string The probable Presence of Children under age 18. Code: Y (Yes).
children string A description derived from CHILDNBRCD (Number of Children Code). E.g., "3 - 5" (Code C).
hhi string A description of the Estimated Household Income range (derived from EHI_V2).
wealth string A description of the estimated Wealth range (derived from WEALTHSCR_V2).
prop_ownerocc string Indicator that the property is Owner Occupied. Code: Y (Yes).
prop_type string Type of property (e.g., "Single Family", "Condominium").
prop_cond string Condition of the property.
year_built string The year the dwelling was built (YYYY).
prop_acres string The property size in acres.
square_feet string The size of the dwelling in square feet.
prop_bedrms string Number of property bedrooms.
prop_fullbaths string Number of property full bathrooms.
prop_sale_date string Date of the most recent property sale (YYYY-MM-DD).
prop_loantoval string Loan-to-Value ratio percentage.
prop_mtgamt string Mortgage Loan Amount.
prop_mtg_date string Mortgage Date (YYYY-MM-DD).
mortgage_loan_type string Type of mortgage loan (e.g., CNV - Conventional).
prop_mtgterm string Mortgage term in years.
prop_mtg_due_date string Mortgage Due Date (YYYY-MM-DD).
prop_rmsequitycd string Estimated Equity Code (1st Mortgage).
prop_mtgintrate string Mortgage interest rate percentage.
prop_mtgintratetype string Mortgage interest rate type (e.g., FIX - Fixed).
prop_mtgamt2...prop_mtgintratetype2 string Fields related to a potential second mortgage.
hequity_est string Estimated Home Equity value.
buyer_score string Consumer Buyer Index (0-99). Higher indicates more likely to buy.
seller_score string Consumer Seller Index (0-99). Higher indicates more likely to sell.
language string The primary language spoken by the individual.

Accessing Additional Data From Scout’s Data Dictionary

If you would like additional data points added to your API feed, please review the Data Dictionary and inquire with [email protected].

API Key Guidance