SmartyList: Web Interface

With access to our SmartyList Web Interface, a person with zero programming experience can process lists of addresses in only a few minutes. Using a simple copy and paste process, you can standardize and validate your addresses and enrich them with relevant data like county name, congressional district, latitude, longitude, and more. The tool can process up to 50,000 US addresses or 5,000 international addresses at once. (For longer lists of US addresses, try our SmartyList Command-Line Interface.) Additionally, the SmartyList Web Interface has a US ZIP Code mode in which you can submit ZIP Codes and get back all the corresponding cities and states, or put in cities and states and get back all the matching ZIP Codes.

You may want to set up a free account to try out your list.


  1. Quick-Start Video
  2. Step-by-Step Instructions
  3. Help

Quick-Start Video

Step-by-Step Instructions

  1. Compile your data in one of these file formats: Excel, CSV, or tab-delimited text.
  2. Organize your data into columns, using one of the combinations shown below. (The more data provided, the better.) The top row MUST consist of column titles, spelled exactly as you see here.

    For US Addresses:
    street | city | state | zipcode
    street | city | state
    street | zipcode
    address (entire address in a single column)

    If you have secondary information (apartment/suite/etc.) in a separate column, label that column secondary. Such a column can be added to any of the first three combinations shown above. For example:
    street | secondary | city | state | zipcode

    11310 Old Seward HighwayAnchorageAK99515
    3211 Edwards Lake PkwyBirminghamAL
    11219 N Rodney Parham Road72212
    4507 North US Highway 89FlagstaffAZ86004

    Still not quite sure? Take a peek at this sample spreadsheet.

    For ZIP Codes:
    city | state | zipcode
    city | state
    Little RockAR
    For International Addresses:
    country | address1 | locality | administrative_area | postal_code
    country | address1 | locality | administrative_area
    country | address1 | postal_code
    country | freeform (entire address except country in a single column)
    AUS200 River TerraceKangaroo PointQueensland4169
    DEUHainichener Strasse 64FreibergSachsen
    PYF21 Allée Pierre LotiPapeete98714
    RUSул. Фурштатская, д. 13191028
    JPNきみ野 6-1-8大和市神奈川県242-0001
  3. Select the columns that contain your address data, including the column titles themselves. Optionally, you can include columns that contain non-address data (like ID number or business name). All the data that is pasted into the tool will always be returned untouched as part of the output. If you do include columns of non-address data, be sure to give those columns non-address titles.
  4. Once you have selected the data, press Control-C (Command-C on a Mac) to copy the data.
  5. Go to the page for the SmartyList Web Interface. Note that, when you are not logged in, this tool offers you only 10 free lookups, but when you are logged in, it draws lookups from your account subscription.
  6. ("Step 1") Choose the appropriate item from the drop-down menu. If you want to add ZIP Codes to street addresses, choose "validate US addresses."
  7. ("Step 2") Click in the box, then type Control-V (Command-V on a Mac) to paste in your input data.
  8. ("Step 3") Press the pretty button.
  9. ("Step 4") After the output appears in the output box, click once in the box to select all the data, then type Control-C (or Command-C) to copy the data to your clipboard.
  10. Go back to your spreadsheet and click in the cell that you want to become the top-left cell of the output data. You can choose to paste on top of your original data, or off to the right in the same sheet, or in a new, blank sheet.
  11. Type Control-V (or Command-V) and voila! Your original data is on the left; ours is on the right, with column titles in brackets.


What does all that data mean?

If you need help understanding the many SmartyList output fields, please see either US Address Output Fields, US ZIP Code Output Fields, or International Output Fields.

My list failed to process.

Check if your input data has line breaks (two lines in the same cell) or quotation marks. These interfere with the tool's ability to sort the data correctly. Here's the solution:

  1. Save your original Excel file in a different file format: "Tab Delimited Text."
  2. Open the new file in a text editor, like Notepad++ for Windows or TextWrangler for Mac.
  3. Copy and paste from the text file into our web page, then continue to follow the instructions above.

My browser crashed, and I lost my processed list.

Please see the "Help" section at the bottom of the SmartyList Web Interface page.

I pasted the output data into my spreadsheet, and now it's a mess.

Excel sometimes makes the wrong assumption when deciding whether to delimit your data by tabs or commas. If this happens:

  1. Check if the pasted output data ended up in a single column. If so, go to the Data menu and choose "Text to Columns." In the dialog box that opens, experiment with choosing to delimit by tabs or commas. Getting the delimiter right will usually solve the problem. If the data did not end up in a single column, proceed with the steps below.
  2. Undo the paste that made a mess.
  3. Open a text editor, like Notepad++ for Windows or TextWrangler for Mac.
  4. Paste the SmartyStreets output data into a new window of the text editor, and save the file.
  5. Go back to your Excel spreadsheet and click on the cell where you want to paste the output data.
  6. From the Excel File menu, choose Import.
  7. Specify "Text file" and click Import.
  8. Navigate to your text file, select it, and click on Get Data.
  9. In the Text Import Wizard, choose the default values.
This site uses cookies for analytics, personalized content, and ads. By continuing to browse this site, you agree to this use.
Consuming raw or undercooked cookie dough may increase your risk of foodborne illness.