For Agents
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.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Interzoid Zip Code Detailed Info API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Interzoid Zip Code Detailed Info API API.
Resolve a US zip code to its City, State, Latitude, and Longitude
Read household income percentages for a zip to segment leads by income bracket
Capture total Population and AreaSquareMiles for a zip into a territory record
Apply MarriedHouseholdPercent and ElderlyHouseholdPercent to demographic targeting
GET STARTED
Use for: I need to enrich a list of customer zip codes with city, state, and population, Get latitude and longitude for a US zip code, Find zip codes where the IncomePercent200k value is above 20, Check the elderly household percentage for a zip code
Not supported: Does not validate full street addresses, support non-US postal codes, or return individual-level demographics — use for zip-level US geographic and household-aggregate enrichment only.
Jentic publishes the only available OpenAPI document for Interzoid Zip Code Detailed Info API, keeping it validated and agent-ready.
The Interzoid Zip Code Detailed Info API returns geographic and demographic detail for a US zip code, including the resolved city and state, latitude and longitude, area in square miles, total population, and household-level percentages for income brackets, married, elderly, and farming households. It is designed to enrich US-shaped data with a single GET call so workflows that hold only a zip code can support segmentation, mapping, and territory planning. The endpoint accepts one zip per call and returns a structured JSON object.
Identify zip codes with FarmerHouseholdPercent above a threshold for sector-specific outreach
Patterns agents use Interzoid Zip Code Detailed Info API API for, with concrete tasks.
★ Lead Segmentation by Income
Segment a US lead list by household income tier by reading IncomePercent50k, IncomePercent100k, and IncomePercent200k for each lead's zip code. The Zip Code Detailed Info API returns these percentages directly, so agents can route the top tier to a high-touch sales queue without buying a separate demographic dataset. The endpoint accepts one zip per call.
For each lead, call /getzipcodeinfo with zip set to the lead's zip and route the lead to the high-touch queue if IncomePercent200k exceeds 20.
Territory Mapping
Place each customer on a map by enriching their zip code with Latitude and Longitude, then aggregate by AreaSquareMiles and Population for territory sizing. The API returns these fields together so a territory tool can call once per zip and persist the result. City and State are echoed back for human-readable labels.
Call /getzipcodeinfo for each customer zip and write the returned Latitude and Longitude into a Mapbox-ready customers table.
Sector-Specific Outreach
Identify zip codes with elevated FarmerHouseholdPercent or MarriedHouseholdPercent to drive sector-specific outreach campaigns. The API returns these household-level percentages alongside core geographic data, so a single call enriches both the geographic and the segmentation needs of the campaign. Rows whose demographic flags fall below threshold can be deprioritized.
Call /getzipcodeinfo for every zip on a US prospect list and filter to zips where FarmerHouseholdPercent exceeds 10 for an agriculture-sector campaign.
Agent-Driven Customer Enrichment via Jentic
An AI customer-enrichment agent uses Jentic to call the Interzoid Zip Code Detailed Info API for every new US signup, writing City, State, Latitude, Longitude, and Population to the customer record. Through Jentic the Interzoid license key is held in the credential vault and never enters the agent context. The agent does not need to ship Interzoid SDK code.
Use Jentic to search for 'get detailed information for a US zip code', load /getzipcodeinfo, and execute it for every new signup to populate the customer's geographic and demographic columns.
1 endpoints — the interzoid zip code detailed info api returns geographic and demographic detail for a us zip code, including the resolved city and state, latitude and longitude, area in square miles, total population, and household-level percentages for income brackets, married, elderly, and farming households.
METHOD
PATH
DESCRIPTION
/getzipcodeinfo
Return city, state, lat/long, area, population, and demographic percentages for a US zip code
/getzipcodeinfo
Return city, state, lat/long, area, population, and demographic percentages for a US zip code
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Interzoid license API key is stored encrypted in the Jentic vault. Agents receive scoped access at execution time and the raw license value never enters the agent context.
Intent-based discovery
Agents search Jentic with an intent like 'get detailed information for a US zip code' and receive the /getzipcodeinfo operation with its input schema, ready to execute.
Time to first call
Direct integration with Interzoid: half a day for auth, error handling, and pagination in batch jobs. Through Jentic: under 15 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Smarty US ZIP Code
US zip code lookup focused on validation and city-state-zip combinations rather than demographic detail.
Choose Smarty when only validation and city/state resolution are required, without demographic fields.
Interzoid State Data Standardization API
Standardizes US and Canadian state names to two-letter abbreviations, often run alongside zip enrichment.
Use to validate the State value returned by the zip lookup against the state held on the source row.
Interzoid Get Weather By Zip Code API
Returns current weather for a US zip code, useful when a workflow needs both demographic and live-conditions data.
Use together when a single workflow needs both demographic context and live weather for a zip.
Specific to using Interzoid Zip Code Detailed Info API API through Jentic.
What authentication does the Interzoid Zip Code Detailed Info API use?
The API uses an Interzoid license key passed as the required `license` query parameter on /getzipcodeinfo. Through Jentic the license key is held in the credential vault and injected at execution time, so the raw key never enters the agent context.
Can I retrieve latitude and longitude with this API?
Yes. The 200 response on /getzipcodeinfo includes Latitude and Longitude alongside City, State, AreaSquareMiles, and Population, so a single call covers both geographic and demographic enrichment needs.
What are the rate limits for the Interzoid Zip Code Detailed Info API?
The OpenAPI spec does not declare a numeric rate limit. Each successful call decrements a credit balance returned in the Credits response field, and a 402 status is returned when credits are exhausted. Refer to interzoid.com for current per-license-tier throughput.
How do I enrich a US zip code through Jentic?
Install the SDK with `pip install jentic`, search for 'get detailed information for a US zip code', load /getzipcodeinfo, and execute it with zip set to the five-digit code. The IncomePercent200k, Latitude, and Longitude fields are ready for use.
Does the API cover non-US zip codes?
No. /getzipcodeinfo accepts US zip codes only. For Canadian postal-code enrichment or international postal data, use a different provider.
What does the API return for household demographics?
The 200 response includes IncomePercent50k, IncomePercent100k, IncomePercent200k, MarriedHouseholdPercent, ElderlyHouseholdPercent, and FarmerHouseholdPercent. These are intended for segmentation rather than individual targeting.