Geocodio

Name: Geocodio API
Brand: Geocodio
Availability: InStock

✓ 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.

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.

Install Jentic One Beta (Self-Hosted)

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with Geocodio API

Explore with Jentic

View OpenAPI Document

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.

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

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

HERE Geocoding & Search API

Global geocoding with place search, autosuggest, and category browsing

Choose HERE when you need global coverage beyond US/Canada, place discovery features, or real-time autosuggest — Geocodio is US/Canada-only but offers unique data appends.

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.