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.
hoh string Head of Household indicator. Codes: Y (Yes), N (No).
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.
language string The primary language spoken by the individual.
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).
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.
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_style string The architectural style of the property (e.g., Ranch, Colonial).
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.
hequity_est string Estimated Home Equity value.
prop_mtg_date string Mortgage Date (YYYY-MM-DD).
mortgage_loan_type string Type of mortgage loan (e.g., CNV - Conventional).
prop_mtgloancd string Loan type code for the 1st mortgage.
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.
prop_mtgamt3 string Mortgage Loan Amount for the 3rd mortgage.
prop_mtgdate3 string Mortgage Date for the 3rd mortgage.
prop_mtgdate_processed3 string Normalized/cleaned date for the 3rd mortgage.
prop_mtgloancd3 string Loan type code for the 3rd mortgage.
prop_mtgduedate3 string Due date for the 3rd mortgage.
prop_mtgduedate_processed3 string Normalized due date for the 3rd mortgage.
prop_rmsequitycd3 string Estimated Equity Code for the 3rd mortgage.
prop_mtgintratetype3 string Interest rate type (Fixed/Adj) for the 3rd mortgage.
prop_mtgterm3 string Term length for the 3rd mortgage.
prop_mtgintrate3 string Interest rate percentage for the 3rd mortgage.
cpi_political_index_tilt string Political index tilt score, indicating the strength of partisan lean.
ct_political_partyaff string Party affiliation (e.g., Republican, Democrat, Independent).
ct_donor_status_pol string Indicates if the individual is a known political donor.
ct_political_outlk string Political Outlook (e.g., Conservative, Liberal).
segment_tags_raw string The raw system codes for segment categorizations.
segment_tags string User-friendly tags categorizing the record into specific marketing segments.

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