An Advanced Look at US Autocomplete Pro API

June 28, 2022
WEBINAR RECAP: We hosted a webinar talking about Smarty’s US Autocomplete Pro API and how it differs from other autocomplete tools in reliability, accuracy, & customizability.

Improving address form completion rates—whether in a shopping cart, request for quote, or other form—can be a sinch if you’re using an address autocomplete tool. Not sure what that is? When you see an address line on a form and think “oh shoot this is going to take a minute” and then it fills it in after only a few keystrokes, that’s address autocomplete.

And no, not all address autocomplete tools are created equal.

Some check against their own address database only that is not frequently maintained. Some are only checked against the United States Postal Service database so they do not include non-postal addresses. And most do not have any sort of customization options when it comes to utilizing their APIs.

Smarty’s US Autocomplete Pro API checks against our incredibly large database of over 160 million USPS addresses in addition to over 15 million non-postal addresses, and it is highly customizable.

Customizing For Geolocation

One typical use for US Autocomplete is to assist an end user entering in their own address. In this case, you likely want to provide suggestions that are close to the user's location. The Geolocation feature, which is turned on by default, does just that. It uses data which maps the user's IP address to a city or surrounding area. It then places their city and state into the prefer_cities field.

Customizing For Preferences

Another use for Autocomplete is for call centers where you may want to prefer suggestions that are in specific cities, states or zipcodes. When set, these results will occupy the top percentage (prefer_ration) of the results.


  • prefer_cities=SEATTLE, REDMOND,WA; RENO, NV
  • prefer_states=CO; OK
  • prefer_zip_codes=84660; 90210&prefer_geolocation=none

Customizing With Include Filters

Sometimes you want to limit results to only specific cities, states or zipcodes. This is different from preferences that could provide suggestions outside your preference areas. Filters will only show suggestions that match the filter. Note that there are some keywords you can use for states that will filter on the 48 contiguous states (including DC) which exclude territories, Alaska and Hawaii. Or all states which exclude just the territories.

As with preferences, if you use the zipcode filter, you cannot use any other preference or filter.

Customizing With Exclude Filters

If you need to exclude specific states from your results, you can use this filter. It cannot be used with any other filter or the geolocation preference, but it works with other preference settings.

Customizing the Source

US Autocomplete Pro has included non-postal addresses for a little over 6 months. Non-postal addresses are those that USPS will not deliver to, but are valid physical addresses. By default, only postal addresses will be returned.

Set this to “all” if you want to return non-postal addresses also. You will know if a result is a non-postal address if it contains the source field with the value of “other”.

Customizing a Selected Secondary

This parameter gets it name from when a user selects an address to drill down on a particular secondary. This is the most complicated one of the options discussed in the webinar but I’ll do my best to summarize.

If the address submitted is an appartment building with 100 units, this will dictate how many of those units there are, and if the user can drill down to an exact unit. You can learn more about it in the recording below beginning at 18:40.

View the Webinar Recording

This is just a brief overview of what was covered. You can view the full 26 minute video below.

Subscribe to our blog!
Learn more about RSS feeds here.
Subscribe Now
Get our latest eBook!
Evaluating a geocoding tool?
Get the buyer's guide
smarty logo
Download now
Read our recent posts
Rising Parcel Shipping Costs in 2022: How to Cut Your Shipping Expenses
Arrow Icon
Parcel shipping costs have been rising since 2020. We’ve all seen inflation on the consumer end, whether we’re checking out online or paying at the gas pump. And skyrocketing freight rates have made headlines. Today, we’re going to focus on the impact of the increasing cost of shipping on your business and what you can do about it. But don’t lose hope—while we’re going to explore climbing shipment costs in this article, we’ll also chat about what your business can do to make shipping more efficient.
How to Clean Address Data For the Holiday Rush
Arrow Icon
It’s November, and online shopping is ramping up to its climactic end-of-year blitz. www. blackfriday. com estimates that between Thanksgiving and Black Friday of this year, consumers will spend approximately $13 billion 1. That’s great news for your business. But if you don’t have the right tools in place to help you meet that demand, you might be left wishing you had better prepare. Staffing may be one issue for many businesses. According to the US Chamber of Commerce, the wholesale and retail trade industry has experienced the second-highest quit rate of all industries since November 20202.
Helpful Hints to Authenticating Your APIs
Arrow Icon
We brought out the big guns in the way of our Development Team Lead, Kent Gividen, in a webinar all about authenticating your APIs. He went over some of his most useful tips and tricks that he uses to ensure APIs are authenticated. Was it helpful? You betcha. You wanna get the sparknotes? Read on. Common and Not-So-Common APIs to Know About Kent began by outlining the APIs that he has run into the most in his years as a developer. Some of them he dug into a little deeper than others, but these are all useful to be aware of.

The leader in location data intelligence

Ready to get started?