people-property

# People & Property Search with Whitepages > **STOP — Read before making any API call.** enrichx402.com endpoints are **not** the same as each provider's native API. All paths use the format `https://enrichx402.com/api/{provider}/{action}`. You MUST either: > 1. Copy exact URLs from the Quick Reference table below, OR > 2. Run `x402.discover_api_endpoints(url="https://enrichx402.com")` to get the correct paths > > **Guessing paths will fail** with 405 errors (wrong path) or 404 errors (missing `/api/` prefix). Access people and property search through x402-protected endpoints. ## Setup See [rules/getting-started.md](rules/getting-started.md) for installation and wallet setup. **Important:** This skill provides access to personal information. Review [rules/privacy.md](rules/privacy.md) before use. ## Quick Reference | Task | Endpoint | Price | Description | |------|----------|-------|-------------| | Person search | `https://enrichx402.com/api/whitepages/person-search` | $0.44 | Find people by name/location | | Property search | `https://enrichx402.com/api/whitepages/property-search` | $0.44 | Property and owner info | ## Person Search Search for a person by name and location: ```mcp x402.fetch( url="https://enrichx402.com/api/whitepages/person-search", method="POST", body={ "firstName": "John", "lastName": "Smith", "city": "Seattle", "state": "WA" } ) ``` **Parameters:** - `firstName` - First name (required) - `lastName` - Last name (required) - `city` - City name - `state` - State abbreviation (US) - `zip` - ZIP code - `address` - 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: ```mcp x402.fetch( url=".../whitepages/person-search", body={ "firstName": "John", "lastName": "Smith", "address": "123 Main St", "city": "Seattle", "state": "WA", "zip": "98101" } ) ``` ## Property Search Search for property information: ```mcp x402.fetch( url="https://enrichx402.com/api/whitepages/property-search", method="POST", body={ "address": "123 Main Street", "city": "Seattle", "state": "WA" } ) ``` **Parameters:** - `address` - Street address (required) - `city` - City name - `state` - 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 1. Confirm legitimate purpose (see [rules/privacy.md](rules/privacy.md)) 2. (Optional) Check balance: `x402.get_wallet_info` 3. **Discover endpoints (required before first fetch):** `x402.discover_api_endpoints(url="https://enrichx402.com")` 4. Search with available details using exact URL from discovery or Quick Reference table above 5. Verify results match expected person ```mcp x402.fetch( url="https://enrichx402.com/api/whitepages/person-search", method="POST", body={"firstName": "Jane", "lastName": "Doe", "city": "Portland", "state": "OR"} ) ``` ### Property Research - [ ] (Optional) Check balance: `x402.get_wallet_info` - [ ] Search by address - [ ] Review owner and property details ```mcp x402.fetch( url="https://enrichx402.com/api/whitepages/property-search", method="POST", body={"address": "456 Oak Avenue", "city": "Austin", "state": "TX"} ) ``` ### Reconnect with Someone - [ ] Confirm legitimate purpose - [ ] Provide as much detail as possible for accuracy - [ ] Review results for correct match ```mcp x402.fetch( url="https://enrichx402.com/api/whitepages/person-search", method="POST", body={"firstName": "Michael", "lastName": "Johnson", "state": "CA"} ) ``` ## Cost Considerations At $0.44 per call, Whitepages is the most expensive endpoint in the x402 suite. | Scenario | Cost | |----------|------| | Single lookup | $0.44 | | Verify address + person | $0.88 | | Multiple candidates | $1.32+ | **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