canonical: https://jentic.com/apis/interzoid.com

# Interzoid APIs

Interzoid is a data-quality and enrichment provider whose APIs help clean, match, standardize, and enrich records. The portfolio covers fuzzy-match similarity keys for addresses, cities, countries, company names, and person names, plus standardization of city and state values, contact enrichment for emails, international phone numbers, and US zip codes, current-rate currency conversion and FX rate lookups, current time and weather lookups by locale or zip, area-code resolution, and page-load performance probing from global origins. Every API is a single read-only GET endpoint authenticated with an Interzoid license key passed as a query parameter, returning structured JSON along with a remaining-credit balance.

## For AI agents

An agent can standardize and deduplicate messy contact and address data, generate fuzzy-match similarity keys to join or merge records, validate emails and enrich phone numbers and zip codes, convert currencies at live rates, and look up local time, weather, or page-load latency, all through Interzoid's single-endpoint GET APIs. Each call is read-only and returns structured JSON, so an agent can chain several Interzoid lookups inside one data-cleansing or enrichment workflow.

## Scope

Use for: Cleaning, matching, standardizing, and enriching contact and address records with Interzoid's single-call GET APIs: similarity keys for dedup, city and state standardization, email and phone and zip enrichment, currency conversion, and time, weather, and page-load lookups.

Not supported:
- full address validation
- geocoding
- historical FX data
- weather forecasts
- money movement
- carrier identity lookup

## APIs

| API | Category | Endpoints | Description |
| --- | --- | --- | --- |
| Interzoid City Data Standardization API | data-enrichment | 1 | Standardise a free-text city name into Interzoid's canonical form ahead of deduplication, joins, or analytics. |
| Interzoid Convert Currency Rate API | finance | 1 | Convert an amount from one currency to another at the current FX rate via a single Interzoid GET call. |
| Interzoid Get Address Match Similarity Key API | data-enrichment | 1 | Generate a similarity key for a street address so variant spellings dedupe to the same key for fuzzy matching and merging. |
| Interzoid Get Area Code API | data-enrichment | 1 | Look up the city, state, and country for a North American telephone area code. |
| Interzoid Get Area Code From Number API | data-enrichment | 1 | Take a full phone number and return the area code plus its city, state, and country. |
| Interzoid Get City Match Similarity Key API | data-enrichment | 1 | Generate a similarity key for a city name to deduplicate or fuzzy-match city columns across datasets. |
| Interzoid Get Company Name Match Similarity Key API | data-enrichment | 1 | Generate a similarity key for a company name to deduplicate accounts and join lead lists. |
| Interzoid Get Country Match Similarity Key API | data-enrichment | 1 | Generate a similarity key for a country name to deduplicate or fuzzy-match country columns across datasets. |
| Interzoid Get Currency Rate API | finance | 1 | Get the latest USD exchange rate for an ISO currency code. |
| Interzoid Get Email Information API | data-enrichment | 1 | Validate an email for deliverability and classify it by entity type. |
| Interzoid Get Full Name Match Similarity Key API | data-enrichment | 1 | Generate a similarity key for a person's full name in a single field for contact deduplication. |
| Interzoid Get Full Name Parsed Match Similarity Key API | data-enrichment | 1 | Generate a similarity key for a person's name when first and last name are in separate fields. |
| Interzoid Get Global Phone Number Information API | data-enrichment | 1 | Look up city, country, language, mobile classification, and wealth signals for an international phone number so an agent can enrich, route, or segment a contact record. |
| Interzoid Get Global Time API | data-enrichment | 1 | Look up the current local time, weekday, and timezone for any city, region, or country worldwide so an agent can schedule, gate, or display time-sensitive actions in the user's locale. |
| Interzoid Get Weather By Zip Code API | data-enrichment | 1 | Look up current temperature, wind, humidity, and visibility for a US zip code so an agent can enrich a delivery, dispatch, or routing decision with live weather conditions. |
| Interzoid Get Weather City API | data-enrichment | 1 | Look up current temperature, wind, humidity, and visibility for a US city and state pair so an agent can enrich a routing, dispatch, or status decision with live conditions. |
| Interzoid Global Page Load Performance API | developer-tools | 1 | Measure how long a URL takes to load from a chosen global origin so an agent can compare regional latency, run availability probes, or flag CDN regressions. |
| Interzoid State Data Standardization API | data-enrichment | 1 | Standardize a US state or Canadian province name to its two-letter abbreviation so an agent can clean inbound data, build reliable joins, or filter on a normalized state column. |
| Interzoid Zip Code Detailed Info API | data-enrichment | 1 | Look up city, state, lat/long, and demographic detail for a US zip code so an agent can enrich a contact, segment by income, or place a row on a map. |

## Which API to use

| Need | API | Why |
| --- | --- | --- |
| Fuzzy-match a company name for account dedup | interzoid-get-company-name-match-similarity-key-ap | Returns a similarity key for a company string so variant legal-entity spellings collapse to one key. |
| Fuzzy-match a person's name in one field | interzoid-get-full-name-match-similarity-key-api | Generates a similarity key for a single-field full name; use the parsed variant when first and last name are separate. |
| Fuzzy-match a full street address | interzoid-get-address-match-similarity-key-api | Returns an address similarity key for deduplication and cross-system merges. |
| Convert an amount between two currencies | interzoid-convert-currency-rate-api | Returns the converted amount and the rate applied in one call; use the rate API when you only need the raw rate. |
| Get a raw FX rate without converting | interzoid-get-currency-rate-api | Returns the latest USD exchange rate for an ISO currency code to apply elsewhere. |
| Enrich a US zip code with demographics | interzoid-zip-code-detailed-info-api | Returns city, state, lat/long, population, and household percentages; use the weather-by-zip API for live conditions. |
| Get current weather for a US location | interzoid-get-weather-by-zip-code-api | Looks up conditions by zip code; use the weather-city API when the row holds a city and state instead. |
| Resolve an area code from a phone number | interzoid-get-area-code-from-number-api | Takes a full phone number and returns the area code with its city, state, and country; use the area-code API when you already have the code. |

## Cross-API use cases

### Full contact-record cleansing before CRM import

An agent cleans an inbound contact list by validating each email for deliverability, generating a full-name similarity key to cluster duplicate people, and generating an address similarity key to confirm the match, then writes only unique, deliverable contacts into the CRM.

Example prompt: For each imported row, validate the email, compute the full-name and address similarity keys, group rows sharing keys, and load only deliverable, unique contacts.

### Standardize then match an address dimension

An agent normalizes the state value to its two-letter abbreviation and standardizes the city name, then generates an address similarity key so variant spellings of the same location collapse to one key for a hash-style join across two systems.

Example prompt: Standardize each row's state and city, compute the address similarity key, and join records across systems on the resulting key.

### B2B account and contact deduplication

An agent deduplicates a lead list by computing a company-name similarity key to cluster accounts and a full-name similarity key to cluster people, so overlapping accounts and contacts are merged instead of pursued twice.

Example prompt: Compute company and full-name similarity keys for each lead, group rows sharing keys, and suppress leads whose keys already exist in the CRM.

### Location-aware delivery dispatch

An agent enriches a delivery zip code with city, state, and coordinates, checks the local time to confirm the destination is inside business hours, and reads current weather conditions before confirming or deferring the dispatch.

Example prompt: For each open route, resolve the zip to a locale, check that the local time is inside business hours, and defer dispatch if weather thresholds are breached.

## Why Jentic

- **Setup:** Wiring Interzoid by hand means registering for a license key and appending it as a query parameter on every call across many separate endpoints. With Jentic you install once, add the Interzoid APIs you need from the Jentic API Directory, store the license key once, and your agent calls any of them.
- **Permission scoping:** Every Interzoid API is a single read-only GET lookup, so scoping is at the operation level. Your own rules in your Jentic One instance limit the agent to the specific Interzoid operations a workflow needs, and because none of the endpoints write or delete there is nothing destructive to guard.
- **Credential handling:** Your single Interzoid license key is stored once, encrypted, by your own Jentic One instance and injected as the license query parameter at execution time. It never enters the agent's prompt, logs, or context, and the same stored key covers every Interzoid endpoint.
- **Discovery method:** Agents search the Jentic directory by intent, such as 'similarity key for a company name' or 'get current weather for a US zip code', and Jentic returns the matching Interzoid operation with its input schema so the agent calls the right endpoint without browsing reference docs.

## Related vendors

- **Smarty** — Address and zip-code validation that pairs with Interzoid's standardization and similarity-key matching for full address hygiene.
- **Abstract API** — Multi-purpose data APIs including email, phone, and address validation that overlap with Interzoid's enrichment endpoints.
- **OpenWeatherMap** — Global weather with forecasts and history where Interzoid returns only current US conditions.
- **Twilio** — Phone-number lookup with carrier and line-type detail beyond Interzoid's geographic phone enrichment.

## FAQ

### What can I build with Interzoid's APIs together?

The endpoints combine into data-cleansing and enrichment workflows. A common pattern standardizes city and state values, generates similarity keys for addresses, company names, and person names to deduplicate records, then enriches the survivors with email deliverability, phone, zip demographics, currency, time, or weather data. Because every call is a single read-only GET, an agent can chain several lookups inside one pipeline.

### Do I need a separate key for each Interzoid API?

No. One Interzoid license key works across the entire portfolio. Every endpoint accepts the same key as the 'license' query parameter, so you register once and reuse the credential for city standardization, similarity keys, currency conversion, and every other Interzoid lookup.

### How does billing work across the APIs?

Interzoid uses a credit-per-call model rather than a fixed rate limit. Each successful response includes a Credits field showing the remaining balance on your license, and an HTTP 402 is returned when credits are exhausted. The tier you purchase sets the size of the credit pool that all endpoints draw from.

### What is the difference between the standardization and similarity-key APIs?

Standardization APIs return a single canonical value, such as a two-letter state abbreviation or a canonical city name, so you can normalize a column. Similarity-key APIs return an algorithmic key that collapses variant spellings of the same address, company, or person to one value, so you can dedupe or join on the key instead of comparing raw strings.

### Are the Interzoid APIs read-only and safe for agents to call?

Yes. Every Interzoid endpoint is a single read-only GET that looks up or computes a value and writes nothing back. There are no destructive operations to guard against, so scoping an agent is a matter of limiting it to the specific lookups it needs.

### Which coverage limits should I know before choosing an Interzoid API?

Several endpoints are US-focused: zip-code demographics, weather by zip, and weather by city cover US locations only, and state standardization covers US states and Canadian provinces. Currency conversion uses current rates rather than historical data, and the global phone and global time lookups are international. Check each API's scope before relying on it for a given region.