Geocod Geocodio
Browse all Geocod APIs✓ Official Vendor SpecMaps GeolocationGeocodingapiKey16 EndpointsREST
For Agents
Geocode addresses and reverse geocode coordinates with US/Canada data appends including congressional districts, census tracts, school districts, timezone, and ACS demographics. Supports batch processing up to 10,000 per request.
Use for: I need to geocode a US address and get its congressional district, Find the latitude and longitude for '1600 Pennsylvania Ave NW, Washington DC', Reverse geocode coordinates to get the census tract number, I want to batch geocode 5,000 addresses in one API call
Not supported: Does not handle map rendering, routing, POI search, or international addresses outside US/Canada — use for North American geocoding and data appends only.
Geocode individual and batch addresses to coordinates, reverse geocode coordinate pairs to addresses, and append data fields like congressional districts, census tracts, school districts, timezones, and ACS demographics to results. The API supports single and batch requests (up to 10,000 addresses per batch), spreadsheet-based list processing with job management, a distance calculation feature for measuring driving or straight-line distance between geocoded results and destination points, and US/Canada-specific address parsing across 16 endpoints.
Install Jentic One Beta
Connect the Geocodio to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Geocodio, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# 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.
Capabilities
What an agent can do with Geocodio API.
Geocode single addresses or batches of up to 10,000 addresses per request with structured or free-form queries
Reverse geocode coordinate pairs to full street-level addresses with configurable result limits
Append congressional district, state legislative district, school district, census tract, and ACS demographic data to geocoded results
Calculate driving distance and duration or straight-line distance between geocoded results and destination points
Process spreadsheet uploads as asynchronous geocoding jobs with status tracking and download endpoints
Resolve stable address keys directly to canonical address results without re-geocoding
Use Cases
Patterns agents use Geocodio API for, with concrete tasks.
★ AI Agent Political District Lookup
AI agents resolve voter addresses to their congressional districts, state legislative districts, and unified school districts for civic tech applications. Through Jentic, agents search for 'geocode with congressional district' and receive the /geocode operation schema with the fields parameter. Pass fields=cd,stateleg,school and the address to get coordinates plus all district assignments in a single call. Supports the current and upcoming (118th/119th) Congress.
Geocode '1600 Pennsylvania Ave NW, Washington DC' with fields=cd,stateleg using the /geocode endpoint and return the latitude, longitude, and congressional district identifier
Batch Geocoding for Real Estate Datasets
Real estate platforms geocode thousands of property listings in bulk to place them on maps and enrich them with census and school district data. The POST /geocode endpoint accepts up to 10,000 addresses per request as a JSON array, returning coordinates and optional field appends for each. For larger datasets, the /lists endpoint handles CSV/Excel uploads as asynchronous jobs with progress tracking.
Batch geocode three addresses ['1600 Pennsylvania Ave NW, Washington DC', '1 Apple Park Way, Cupertino CA', '350 5th Ave, New York NY'] via POST /geocode with fields=timezone and return coordinates and timezone for each
Distance Calculation for Delivery Zones
Delivery and logistics platforms determine which destinations are reachable from a geocoded warehouse address within time or distance thresholds. The destinations[] parameter calculates driving or straight-line distance from each geocoded result to a list of destination points. Results include distance in miles or km and driving duration in seconds, with filtering by max distance and duration.
Geocode '350 5th Ave, New York NY' with destinations[]='40.7484,-73.9857' and distance_mode=driving using the /geocode endpoint and return the driving distance and duration
Census Data Enrichment for Demographics
Market research and social science applications enrich address datasets with American Community Survey (ACS) demographics, census tract identifiers, and county FIPS codes. The fields parameter supports cd, stateleg, school, census, timezone, and acs-demographics among others. Results include tract codes, block group identifiers, and demographic statistics for the surrounding area.
Geocode '1109 Highland Ave, Austin TX' with fields=census,acs-demographics using the /geocode endpoint and return the census tract code and total population
Key Endpoints
16 endpoints — geocode individual and batch addresses to coordinates, reverse geocode coordinate pairs to addresses, and append data fields like congressional districts, census tracts, school districts, timezones, and acs demographics to results.
METHOD
PATH
DESCRIPTION
GET
/geocode
Geocode a single address with optional data appends
POST
/geocode
Batch geocode up to 10,000 addresses
GET
/reverse
Reverse geocode coordinates to address
POST
/reverse
Batch reverse geocode multiple coordinate pairs
GET
/distance
Calculate distance between two locations
GET
/lists
List spreadsheet geocoding jobs
GET
/lists/{id}
Get status of a geocoding job
GET
/lists/{id}/download
Download completed geocoding results
GET
/geocode
Geocode a single address with optional data appends
POST
/geocode
Batch geocode up to 10,000 addresses
GET
/reverse
Reverse geocode coordinates to address
POST
/reverse
Batch reverse geocode multiple coordinate pairs
GET
/distance
Calculate distance between two locations
GET
/lists
List spreadsheet geocoding jobs
GET
/lists/{id}
Get status of a geocoding job
GET
/lists/{id}/download
Download completed geocoding results
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Geocodio API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access tokens — the raw `api_key` query parameter value never enters the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'geocode with congressional district' or 'batch geocode addresses') and Jentic returns matching Geocodio operations with their full input schemas, so the agent can call the correct endpoint without reading Geocodio documentation.
Time to first call
Direct Geocodio integration: 1-2 days for auth, field selection, batch handling, and error management. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
LocationIQ API
Global OSM-based geocoding with routing, timezone, and POI search
Choose LocationIQ when you need global coverage, routing between waypoints, or nearby POI search — Geocodio focuses on US/Canada with political/census data.
Alternative
positionstack API
Simple global geocoding with batch support and timezone/country modules
Choose positionstack when you need simple global forward/reverse geocoding with timezone and country data modules but do not need US-specific political district appends.
FAQs
Specific to using Geocodio API through Jentic.
What authentication does the Geocodio API use?
Geocodio authenticates requests using an API key passed as the `api_key` query parameter. Through Jentic, your Geocodio API key is stored encrypted in the MAXsystem vault — agents receive scoped access without the raw key entering their context.
Can I batch geocode thousands of addresses with Geocodio?
Yes. The POST /geocode endpoint accepts a JSON array of up to 10,000 addresses per request. For larger datasets, upload a CSV or Excel file via the /lists endpoint for asynchronous processing. Track job status with GET /lists/{id} and download results with GET /lists/{id}/download.
What data fields can Geocodio append to geocoded results?
Pass the `fields` parameter with comma-separated values: cd (congressional district), stateleg (state legislative districts), school (school districts), census (tract/block/county FIPS), timezone, acs-demographics (ACS population data). Multiple fields can be combined in a single request.
What are the rate limits for the Geocodio API?
Free tier allows 2,500 lookups per day and batch requests of up to 10,000 addresses. Paid plans remove daily limits and support the full feature set including HTTPS access and all data append fields. The API returns HTTP 422 for invalid requests and 403 for plan-restricted features.
How do I get congressional district data for an address through Jentic?
Install the Jentic SDK with `pip install jentic` and search for 'geocode with congressional district'. Jentic returns the /geocode operation schema. Pass your address as the `q` parameter and set `fields=cd,stateleg`. Execute through Jentic to get coordinates plus the current congressional district number, representative info, and state legislative assignments.
Does Geocodio support international addresses?
Geocodio focuses on the United States and Canada. The `country` parameter defaults to 'US' and accepts 'CA' for Canadian addresses. For global geocoding needs, consider alternatives like HERE, TomTom, or LocationIQ.
GET STARTED