Generate an Address¶

The address() method returns one or more fake postal addresses for a given ISO 3166-1 alpha-2 country code.

Single address¶

from smartfaker import Faker

faker = Faker()
addr = faker.address("us")
print(addr["city"], addr["zip"])

Pass amount=N to receive a list:

addrs = faker.address("fr", amount=5)
for a in addrs:
    print(a["city"])

import asyncio

async def main():
    addr = await faker.aaddress("jp")
    print(addr["city"])

asyncio.run(main())

Each address dict carries country-specific fields plus three metadata keys:

See Response Schema for the full schema.