API Overview
The same address often appears in your data many different ways: "1777 st louis rd", "1777 saint louis road", "1777 saint louis raod". To a database, those are three different locations.
That inconsistency quietly erodes the value of your data. It creates duplicate customer, property, and location records, causes duplicate mailings and shipments, wastes marketing spend, and undermines reporting, analytics, and AI initiatives. It is also hard to fix. Exact-match joins miss these records entirely, and simple fuzzy matching struggles with abbreviations, directionals, unit designators, numbers written as words, and typos.
The Address Match Similarity Key API solves this by generating a similarity key for each street address, so inconsistent addresses can be matched, deduplicated, and linked within or across your data sources and datasets.
Similarity Keys
Generates similarity keys for matching of street addresses, avoiding issues with data inconsistency and human-entered address format standards and variations.
Flexible Algorithms
Choose matching algorithms such as 'model-v3-narrow' or 'model-v3-wide' to suit your specific use case. A 'narrow' algorithm considers the unit designator (suite, apt, etc.) when generating similarity keys to match with, whereas a 'wide' algorithm does not.
Advanced Techniques
Utilizes artificial intelligence, machine learning, heuristics, phonetics, knowledge bases, and specialized algorithms for accurate matching.
How It Works
Addresses that look different to a computer generate the identical similarity key, so finding a match becomes a simple exact comparison.
Vy77jRfV0SR11wdJwDO0Cvzh4xCg
pdsjjImDHMQUX6EMlBHD9H17SAoTamH6zCBjFm1
Addresses generating the same similarity key are considered "similar" and possibly the same. Once generated, these similarity keys can be used in many ways. This includes sorting by similarity key in one dataset to find duplicates, using them as a basis for matching across datasets to significantly increase match rates, or as an index as part of a fuzzy search mechanism for better, more comprehensive search results.
Best practice: This API is designed to match on street address data, not city/state/zip information. We recommend generating a similarity key from the street address, and then appending the address's zip code to create a "combination similarity key" for best results. Contact us at support@interzoid.com for more details.
API Details
Endpoint
https://api.interzoid.com/getaddressmatchadvanced
Request Format
https://api.interzoid.com/getaddressmatchadvanced?license=[apikey]&address=[street address]&algorithm=[model-v3-wide or model-v3-narrow]
Sample Request
https://api.interzoid.com/getaddressmatchadvanced?license=fh5hs7*****&address=400 East Broadway St&algorithm=model-v3-narrow
Sample Response
{"SimKey":"d477E1d7sG6dja3hDNsk9P","Code":"Success","Credits":5794029}
cURL Example (with API key in header)
curl --header "x-api-key: fh5hs7*****" "https://api.interzoid.com/getaddressmatchadvanced?address=400%20East%20Broadway&algorithm=model-v3-narrow"
Algorithm & AI Model Options
narrow
Matches considering unit designators (suite, apt, etc.). Very fast but less accurate than AI options.
wide
Matches on street address only, ignoring unit designators. Very fast but less accurate than AI options.
model-v3-narrow
Our latest model - best accuracy and considers unit designators (APT, Suite, etc.)
Recommendedmodel-v3-wide
Our latest model, matching on street address only.
Additional Resources
Try this API Interactively
Our API interactive usage tool enables you to try this API interactively with a user interface and without writing code. The tool is available for all of our APIs.
Try it NowUse this API in a High-Performance, No-Code, Cloud Batch Mode
Our Match Wizard no-code batch tool enables you to quickly use this API within our parallel-processing Cloud platform, processing text files (CSV/TSV) with a few clicks and without writing code. This is the fastest and easiest way to use this API with higher volumes of data, enabling matching within or across datasets in minutes.
Start NowService Bureau - Our Data Cleansing and Data Enrichment Task Force
Want us to do it for you? We can take your data and use our products on your behalf with a quick turnaround:
Contact SupportPay-Per-Call Access for AI Agents via x402
AI agents can access this API using x402 without any setup or API key. The agent receives the payment request, pays the per-call amount in USDC on Base, and retries the request automatically with payment confirmation at which time the request is completed.
Learn MoreCode Examples, Database Queries, and Specifications
See quick and easy code examples in multiple programming languages, including Python, Node.js, Java, Typescript, and Go. Also see how to use within database queries on popular database platforms and open specifications such as OpenAPI.
See All ExamplesSample Address Matches
1000 Fourth Street E
1000 4th St. East
99 Los Angeles Street
99 L.A. Street
455 E Main St
455 East Main
455 Main Street
7000 Cleveland Road
7000 Cleaveland Rd
9000 e calif road
9000 east calif road
1777 st louis rd
1777 saint louis road
1777 saint louis raod
500 Browne lane suite #100
500 Browne ln suite 100
500 brown lane ste 100
9 Johnson Road
Nine Johnston rd
100 first street
100 1st street
Combination Matching: Match on Multiple Fields
Need to match on more than just a street address? Our combination matching APIs generate a single composite similarity key from a street address paired with an additional field, enabling higher-precision matching when you have more data available.
Address + Full Name Matching
Combine a street address with an individual's full name to generate a composite similarity key. Ideal for matching customer records, mailing lists, or any dataset where both an address and a resident or contact name are available.
Explore Address + Full Name APICompany + Address Matching
Combine a street address with a company or organization name to generate a composite similarity key. Ideal for matching business location data, vendor records, or any dataset where both a company and its address are available.
Explore Company + Address API