People Property

People & Property Search with Whitepages

Access people and property search through x402-protected endpoints.

Setup

See rules/getting-started.md for installation and wallet setup.

Important: This skill provides access to personal information. Review rules/privacy.md before use.

Quick Reference

Person Search

Search for a person by name and location:

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/person-search -m POST -b '{
  "first_name": "John",
  "last_name": "Smith",
  "city": "Seattle",
  "state_code": "WA"
}'

IMPORTANT: The state parameter is named state_code, NOT state. Use two-letter state abbreviations (e.g., 'CA', 'NY', 'TX').

Parameters:

• first_name - First name (required)
• last_name - Last name (required)
• city - City name
• state_code - Two-letter state abbreviation (US)
• zip - ZIP code
• street - Street address

Returns:

• Full name and age range
• Current and previous addresses
• Phone numbers
• Associated people (relatives, associates)

More Specific Search

Include more details for better matches:

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/person-search -m POST -b '{
  "first_name": "John",
  "last_name": "Smith",
  "street": "123 Main St",
  "city": "Seattle",
  "state_code": "WA",
  "zip": "98101"
}'

Property Search

Search for property information:

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/property-search -m POST -b '{
  "street": "123 Main Street",
  "city": "Seattle",
  "state_code": "WA"
}'

IMPORTANT: The state parameter is named state_code, NOT state. Use two-letter state abbreviations (e.g., 'CA', 'NY', 'TX').

Parameters:

• street - Street address (required)
• city - City name
• state_code - Two-letter state abbreviation
• zip - ZIP code

Returns:

• Property address (standardized)
• Owner name
• Property type (single family, condo, etc.)
• Property details

Response Data

Person Search Fields

• name - Full legal name
• ageRange - Estimated age range
• currentAddress - Current residence
• historicalAddresses - Previous addresses
• phoneNumbers - Associated phone numbers
• associatedPeople - Relatives and associates

Property Search Fields

• address - Standardized address
• owner - Property owner name
• propertyType - Type of property
• yearBuilt - Construction year (if available)
• bedrooms / bathrooms - Property details
• squareFootage - Size (if available)

Workflows

Verify Contact Information

• [ ] Confirm legitimate purpose (see rules/privacy.md)
• [ ] (Optional) Check balance: npx agentcash@latest balance
• [ ] Search with available details
• [ ] Verify results match expected person

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/person-search -m POST -b '{"first_name": "Jane", "last_name": "Doe", "city": "Portland", "state_code": "OR"}'

Property Research

• [ ] (Optional) Check balance: npx agentcash@latest balance
• [ ] Search by address
• [ ] Review owner and property details

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/property-search -m POST -b '{"street": "456 Oak Avenue", "city": "Austin", "state_code": "TX"}'

Reconnect with Someone

• [ ] Confirm legitimate purpose
• [ ] Provide as much detail as possible for accuracy
• [ ] Review results for correct match

npx agentcash@latest fetch https://stableenrich.dev/api/whitepages/person-search -m POST -b '{"first_name": "Michael", "last_name": "Johnson", "state_code": "CA"}'

Cost Considerations

At $0.44 per call, Whitepages is the most expensive endpoint in the x402 suite.

Tips to reduce costs:

• Provide as much info as possible for accurate first-try results
• Use free sources first (LinkedIn, company websites)
• Use apollo, clado, firecrawl, WebSearch, WebFetch, to get data that will make the queries more accurate
• Only use for essential lookups

Limitations

• US-focused data
• Results depend on public records availability
• Some individuals may have limited information
• Recently moved individuals may show old addresses
• Unlisted/private numbers not included

Getting Started

Setup

1. Install the agentcash CLI:

   npm install -g agentcash

2. Check wallet:

   npx agentcash@latest balance

3. Fund wallet (if needed):

• Redeem invite: npx agentcash@latest redeem YOUR_CODE
• Or run npx agentcash@latest accounts to get Base or Solana deposit links and wallet addresses

Troubleshooting

Privacy Considerations

Responsible Use

Whitepages endpoints provide access to personal information from public records. Use responsibly:

Legitimate Uses

• Verifying contact information for business purposes
• Reconnecting with lost contacts (family, old friends)
• Property research for real estate transactions
• Due diligence for business relationships
• Fraud prevention and verification

Inappropriate Uses

• Stalking or harassment
• Unauthorized surveillance
• Bypassing someone's privacy preferences
• Building unauthorized marketing lists
• Any illegal purpose

Data Sensitivity

The data returned may include:

• Home addresses (current and historical)
• Phone numbers
• Age information
• Family relationships
• Property ownership

This is sensitive personal information. Handle appropriately:

• Don't share results unnecessarily
• Don't store results beyond immediate need
• Don't use for purposes the person wouldn't expect
• Respect opt-out requests if contacted

Legal Considerations

• Data comes from public records
• Use must comply with applicable laws
• FCRA applies to certain uses (employment, credit, tenant screening)
• State privacy laws may apply

For regulated uses (employment screening, tenant checks, etc.): Use a proper consumer reporting agency, not general people-search tools.

Best Practices

1. Minimize lookups - Only search when necessary 2. Be specific - Provide enough detail to find the right person on first try 3. Verify context - Ensure you have a legitimate reason 4. Protect results - Don't expose personal data unnecessarily 5. Consider alternatives - LinkedIn, company websites, or direct contact may be better options

When to Use Alternatives

Use Whitepages when other sources don't have the information and you have a legitimate need.