Guide
Learn how to effectively use our address generator
Quick Start Guide
Select Location
Choose a specific state or city, or leave blank for random generation
Generate Data
Click the generate button to create new address information
Use Data
Copy, export, or view the generated information as needed
Detailed Usage Instructions
Location Filter
Use the sidebar filters to control the geographic range of generated addresses:
- State filter: Select a specific US state to limit address generation
- City filter: Select from popular cities for targeted results
- House number filter: Use API parameter has_number=1 to filter addresses with numbers in street addresses (i.e., addresses with house numbers)
Copy and Export Functions
Multiple ways to extract and use the generated data:
- Single field copy: Click any data row to copy that specific information
- Batch copy: Use "Copy All Information" to get formatted text containing all data
- JSON export: Download structured data for programming and database use
Map Integration
View generated address locations on an interactive map to understand geographic context and verify location accuracy.
Pro Tips and Best Practices
Keyboard Shortcuts
Press Ctrl+R (Cmd+R on Mac) to quickly regenerate new address data
Mobile-Friendly
The tool works perfectly on mobile devices, with a touch-optimized interface
Bookmark Filters
Bookmark URLs with state/city parameters for quick access to specific locations
Language Support
Use the language selector to switch between Chinese and English interfaces
API and Integration
For developers who need programmatic access, we provide a RESTful API. To use the API, you need to obtain a Key first. Please contact the administrator to get API access.
// API usage example with curl
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY&state=CA&city=Los-Angeles"// Specify state only
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY&state=CA"// Generate addresses with house numbers (has_number=1)
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY&has_number=1"// Specify state and filter addresses with house numbers
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY&state=CA&has_number=1"// Random generation (no parameters)
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY"
Note: Please replace YOUR_API_KEY in the example with your actual API Key. API Keys have expiration dates and need to be renewed by contacting the administrator after expiration.
Response Example
{
"success": true,
"data": {
"fullName": "John Doe",
"street": "123 Main St",
"city": "Los Angeles",
"state": "CA",
"zipCode": "90001",
...
}
}