U.S. address parser

Try it out! Enter an address in the US, and we'll parse it into fields like AddressNumber, StreetName and ZipCode.


API

Don't know Python? We've set up an easy-to-use API so you can parse on your own stack. Get started »

Bulk parsing

Don't know how to code?
Parse up to 500 addresses using our bulk parser »

For the Python nerds

usaddress is a Python library for parsing unstructured address strings in the United States into address components.

installation

> pip install usaddress

Python usage

Pass in an address string to the usaddress.tag() method, and it will return a tuple containing an OrderedDict with tagged address parts and a String with the address type.

>>> import usaddress
>>> usaddress.tag('123 Main St. Suite 100 Chicago, IL')
(OrderedDict([
  ('AddressNumber', '123'),
  ('StreetName', 'Main'),
  ('StreetNamePostType', 'St.'),
  ('OccupancyType', 'Suite'),
  ('OccupancyIdentifier', '100'),
  ('PlaceName', 'Chicago'),
  ('StateName', 'IL')]),
'Street Address')