Interzoid Global Address Matching API - Find Matching Address Data Worldwide

API Overview

This API generates hashed similarity keys from input global address data, enabling efficient matching and sorting of global address information to identify redundancy and inconsistency across datasets.

Similarity Keys

Generates similarity keys for matching of global addresses, avoiding issues with data inconsistency and human-entered address format standards and variations.

Flexible Algorithms

Choose matching algorithms such as 'ai-medium-narrow' or 'ai-medium-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 globally-aware algorithms for accurate matching.

How It Works

Address Input	Similarity Key
Piazza del Colosseo, 1, Rome RM, Italy	`eotjNaYESCN265V9wtEmo2_jInZ140dTZMmeFoJpGgM`
Piazza del Colosseo, 1, 00184 Rome RM, Italy	`eotjNaYESCN265V9wtEmo2_jInZ140dTZMmeFoJpGgM`
#1 Piazza del Colosseum, 00184 Roma, Italia	`eotjNaYESCN265V9wtEmo2_jInZ140dTZMmeFoJpGgM`
1 Bennelong Point, Sydney NSW 2000, Australia	`X6M11Pnwmtp_8N9y-P9UXSviq76cUG`
One Bennelong Pt., Sydney NSW 2000, Australia	`X6M11Pnwmtp_8N9y-P9UXSviq76cUG`
1 Benelong Point, Sydny, Aust.	`X6M11Pnwmtp_8N9y-P9UXSviq76cUG`
Chatuchak Market, Kamphaeng Phet 2 Rd, Bangkok 10900, Thailand	`Jxhn5m5O4nPNrqEz-FEbdR0PZuW`
Chattuchek Mrkt, Kampheng Phet Two, Bangkok 10900, Tai Lan	`Jxhn5m5O4nPNrqEz-FEbdR0PZuW`
1600 Penn Ave NW, Washington, D.C., USA	`h-zMusl1r3gyeIxQDfz3UEG22`
1600 Pennsylvania Ave. NW, Wash DC, UNITED STATES	`h-zMusl1r3gyeIxQDfz3UEG22`
1600 Pennylvania Avenue NW, Wash DC	`h-zMusl1r3gyeIxQDfz3UEG22`
Pennsylvania Ave #1600 WASHNGTN DC	`h-zMusl1r3gyeIxQDfz3UEG22`
1600 Pennsylvan. Avenue NW, District of Columbia	`h-zMusl1r3gyeIxQDfz3UEG22`
1600Pennsylvana Avenue NW, Washington, District of Columbia (USA)	`h-zMusl1r3gyeIxQDfz3UEG22`

Global addresses generating the same similarity key are considered "similar". These keys can be used for sorting and identifying redundant addresses in a single table or file, matching based on address across datasets, or as a fuzzy search mechanism.

API Details

Endpoint

https://api.interzoid.com/getglobaladdressmatch

Request Format

https://api.interzoid.com/getglobaladdressmatch?license=[apikey]&address=[street address]&algorithm=[ai-medium-wide or ai-medium-narrow]

Sample Request

https://api.interzoid.com/getglobaladdressmatch?license=fh5hs7*****&address=221 B Baker St, Marylebone, London, UK&algorithm=ai-medium-narrow

Sample Response

{"SimKey":"r17f28d477E1d7sG6dja3h13SDkP","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=ai-medium-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.

ai-plus-narrow

AI-enhanced matching considering unit designators. Second-best in performance and accuracy.

ai-plus-wide

AI-enhanced matching on street address only. Second-best in performance and accuracy.

ai-medium-narrow

Best accuracy, considering unit designators. Recommended algorithm, but API response can take a little bit longer.

Recommended

ai-medium-wide

Best accuracy, matching on street address only. API can take a little longer but provides high-quality results.

Only one algorithm can be used as a parameter to the API at a time. Different algorithms will yield different matching results and similarity keys. Matching can occur with values whose similarity keys have been generated with the same algorithm.

Code Examples

Examples in Nine Programming Languages

See quick and easy code examples in nine different popular languages, including Python, Node.js, Java, Typescript, Go, Rust, C#, R, and Scala.

See All Code Examples

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 Now

Address Match Reports

Generate match reports for entire datasets using our Full Dataset API:

Learn More

Web Matching Wizard

No coding necessary - try our Cloud Data Connect Web matching wizard to see this API in action with entire datasets using an intuitive browser interface.

Launch Wizard

Optional OpenAPI Specification

An OpenAPI Specification (OAS) is a standardized format for describing the structure, endpoints, and functionality of a RESTful API in a machine-readable format.

It is a blueprint for developers and enables integration by defining request and response schemas, authentication methods, and available operations.

YAML JSON

Video Description

Watch a short video describing similarity keys and how they work.

YouTube

Excel Integration

Try our Microsoft Excel integration for matching and cleansing data directly within a spreadsheet. It's as easy as calling a pre-integrated Excel function for street addresses in worksheet cells.

Explore Excel Integration

Service Bureau - Our Super-powered Data Matching 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 Support

Sample Address Matches

1 Bennelong Point, Sydney NSW 2000, Australia
One Bennelong Pt., Sydney NSW 2000, Australia
1 Benelong Point, Sydney, Aust. 2000

1600 Pennsylvania Avenue NW, Washington, D.C., USA
1600 Penn Ave NW, Washington, D.C., USA
1600 Pennsylvania Ave. NW, Wash DC
1600 Pennsylvania Avenue NW, Wash DC, UNITED STATES
1600 Pennylvania Avenue NW, Wash DC
1600 Pennsylvania Avenue NW, Wash DC
Pennsylvania Ave #1600 WASHNGTN DC
1600 Pennsylvan. Avenue NW, District of Columbia
1600Pennsylvana Avenue NW, Washington, District of Columbia (USA)

Buckingham Palace, London, England, SW1A 1AA, UK
Buckingham Palace, London, SW1A 1AA, Utd Kingdom
Buckingham Palace, London, SW1A 1AA, Great Britain
Buckingham Plc, London, SW1A 1AA, UK
Bukingham Palace, London, UK

221B Baker Street, London, UK10 Downing Street, London, England
221 B Baker St, London, UK10 Downing Street, London, UK
221-B Baker Street, London, UK10 Downing St, London, UK
221B Baker Sreet, London, UK 10 Downing Street, London, UK
#221B Baker Street, London, UK10 Downing Street, London, UK
221B Baker Street, London, UK10 Downing Street, London, UK

Piazza del Colosseo, One, 00184 Rome RM, Italy
Piazza del Colosseo, 1, Rome RM, Italy
Piazza del Colosseo, 1, 00184 Rome RM, Italy
1 Piazza del Colosseum, 00184 Roma, Italia
Piazza del Colosseo, 1, 00184 Roma, Italia

No. 1 Nan Chi Zi, Dongcheng, Beijing, China
One Nan Chi Zi, Dongcheng, Beijing, China
1 Nan Chi Zi, Dong Cheng, Beijing
1 Nan Chi Zi, Dong Cheng, Bei Jing

Taj Mahal, Agra, Uttar Pradesh, India
Taj Mahal, Utar Pradesh, India

Brandenburger Tor, Pariser Platz, 10117 Berlin, Germany
Brandenburg Gate, Berlin, Germany

The Grand Palace, Na Phra Lan Rd, Phra Nakhon, Bangkok 10200, Thailand
Grand Palace, Na Phra Lan Rd, Phra Nakhon, Bangkok 10200, Thai Lan
The Grand Palace, Na Phra Lan Rd, Phra Nakhon, Bangkok

Chatuchak Market, Kamphaeng Phet 2 Rd, Bangkok 10900, Thailand
Chatuchak Mrkt, Kamphaeng Phet Two, Bangkok 10900, Thailand