Fetch Geocodio data with one API

Normalize a street address through the Geocodio pay-as-you-go geocoding API (v2.1): standardized components, coordinates with provider accuracy type, source name and stable address key, plus optional documented field appends (districts, school, Census, timezone, ZIP+4) billed as extra lookups. Coordinates are geographic matches, not parcel or deliverability proof. No autocomplete or ownership verification. Documentation-backed beta.

Read the docs How it works Try a request

What Geocodio endpoints does RealtyCrawl ship?

Normalize a street address through the Geocodio pay-as-you-go geocoding source (v2.1) for six countries, then read your retained addr_geocodio_ observation. Optional documented field appends (districts, school, Census, timezone, ZIP+4) cost one extra provider lookup each. Each endpoint has a documented request, response schema, and credit cost.

Resolve and normalize a street address

50 credits

POST /v1/addresses/resolve

Normalize a street address through Geocodio, with provider accuracy and optional appends.

address

Read a retained normalized address

1 credits

GET /v1/addresses/{address_id}

Read your account’s saved normalized-address observation.

address_id

Check live capabilities for operation and market availability. Unavailable requests are not charged.

Checking current source coverage…

Source request · Fetches the source through the enabled adapter.

Geocodio API

2 endpoints documented

View docs

POST/v1/addresses/resolveGet API key

address

curl -X POST 'https://realtycrawl.dev/v1/addresses/resolve' \
  -H "x-api-key: $REALTYCRAWL_API_KEY" \
  -H 'X-Max-Credits: 50' \
  -H "Idempotency-Key: YOUR_IDEMPOTENCY_KEY" \
  -H "content-type: application/json" \
  -d '{"address":{"formatted":"123 Example Street, Austin, TX","country":"US"}}'

API key required

// Live requests require a RealtyCrawl API key.
// Copy the request to your backend and set REALTYCRAWL_API_KEY.
// Check source and operation availability before running a request.

How the Geocodio API works

Integrate a source-linked real estate API with standard HTTP requests, one API key, and structured JSON responses.

Authenticate every call

Send your RealtyCrawl API key in the x-api-key header. Keep it in your server environment.

GET and POST requests

Use path and query parameters for GET requests. Send a JSON body for POST operations.

One credit system

Source requests cost 50 credits per successful call. Saved reads cost 1 credit per observation, including successful saved-batch items. Failed calls are refunded; usage and balance appear in the response headers.

JSON and data exports

JSON keeps data and meta together. Field projection and CSV/NDJSON exports are response options; export request and credit metadata stays in headers.

The usual integration chain

From a supported source operation to data in your application.

1CheckGET /v1/meta/capabilitiesConfirm coverage and accepted selectors.
2RequestPOST /v1/addresses/resolveSend the inputs for the selected operation.
3Readdata + metaInspect results, source outcomes, and warnings.
4ConnectYour applicationPreserve identifiers and observation times.

Request

curl --request POST 'https://realtycrawl.dev/v1/addresses/resolve' \
  --header "x-api-key: $REALTYCRAWL_API_KEY" \
  --header 'X-Max-Credits: 50' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: YOUR_IDEMPOTENCY_KEY' \
  --data '{"address":{"formatted":"123 Example Street, Austin, TX","country":"US"}}'

Illustrative response

{
  "data": {"status":"matched","candidates":[{"id":"addr_geocodio_4b825dc642cb6eb9a060e54bf8d69288","entity_type":"address","confidence":1,"method":"geocodio_geocode_normalize","source":{"platform":"geocodio","provider":"geocodio","country":"US","access_class":"licensed_feed","observed_at":"2026-01-01T12:00:00Z","retrieved_at":"2026-01-01T12:00:00Z","native_id":"gcod_examplestablekey","url":null}}]},
  "meta": {
    "request_id": "example_request",
    "schema_version": "1.0.0",
    "generated_at": "2026-01-01T12:00:00Z",
    "completeness": "unknown",
    "sources": [
      {
        "platform": "geocodio",
        "status": "success"
      }
    ]
  }
}

What lands in data

Source context stays with the property observations.

Address: formatted · line1 · unit · city · region · postal_code · country
Match: accuracy · accuracy_type · source_name · stable_key
Geometry: latitude · longitude · precision · crs
Source: platform · provider · observed_at · access_class

Inside the gateway

One request keeps the source, operation, and result connected.

Operation selection

Your path selects the platform and operation. Capabilities describe accepted selectors and markets.

Source collection

The gateway routes supported requests to the configured source and records its outcome.

Contract normalization

Property attributes, prices, and units are mapped into a shared JSON schema.

Response metadata

Completeness, warnings, and source timestamps help your application interpret the result.

Billing rules that make evaluation clear

Source requests cost 50 credits per successful call. Saved reads cost 1 credit per observation, including successful saved-batch items.
500 signup trial credits
Failed calls are refunded
Usage in response headers
Set an X-Max-Credits budget
One key across the catalog

How we get the data

A source request becomes a structured observation, with its origin and collection time attached.

What your request targets

Geocodio street-address normalization records through a supported listing operation. Catalog markets: United States · Canada · Mexico · United Kingdom · Australia · New Zealand.

How records are returned

Search returns normalized listing IDs for saved reads. Use URL or native-ID detail only where that source operation is documented and enabled.

What comes with each result

Operation-specific resource fields sit alongside source identifiers, collection times, and completeness metadata.

What an observation means

Collection time and source update time describe different events. Stored observations expire after 24 hours without triggering a fresh crawl.

SOURCE → SHARED SCHEMA

Listing identifier

→ source.native_id

Published asking price

→ price.amount + currency

Collection timestamp

→ source.observed_at

What this API
is used for

Source-linked data for property products and research.

documented operations

1–50

credits per call / batch item

property workflows

Coverage and field availability vary by source. Check capabilities before you start a workload.

What people build with the Geocodio API

Turn street-address normalization observations into tools your team can use.

Use case examples

Connect one source to the tools and workflows you already use.

Search applications

REST · application backend

Search returns normalized listing IDs for saved reads. Use URL or native-ID detail only where that source operation is documented and enabled.

Research pipelines

JSON · notebooks · BI

Compare property observations with their currencies, area units, and timestamps.

Assistant workflows

MCP · tools · agents

Give an assistant supported data operations with explicit request budgets.

Make your first request

Choose an operation, supply its inputs, and send your API key from your backend.

Resolve and normalize a street address

curl --request POST 'https://realtycrawl.dev/v1/addresses/resolve' \
  --header "x-api-key: $REALTYCRAWL_API_KEY" \
  --header 'X-Max-Credits: 50' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: YOUR_IDEMPOTENCY_KEY' \
  --data '{"address":{"formatted":"123 Example Street, Austin, TX","country":"US"}}'

Read a retained normalized address

curl --request GET 'https://realtycrawl.dev/v1/addresses/addr_geocodio_4b825dc642cb6eb9a060e54bf8d69288' \
  --header "x-api-key: $REALTYCRAWL_API_KEY" \
  --header 'X-Max-Credits: 1'

Geocodio API

Same key as the rest of the catalog

Get an API key Read the docs ↗

Endpoints

What data does the Geocodio API return?

JSON responses preserve the operation data and request metadata. Supported data operations also offer response field projection and CSV/NDJSON exports.

Resolve and normalize a street address

Normalize a street address through Geocodio, with provider accuracy and optional appends.

Read a retained normalized address

Read your account’s saved normalized-address observation.

Comparison

How does RealtyCrawl structure Geocodio data?

Keep the source context while using the same request and response conventions across your integration.

Source context and RealtyCrawl conventions
Your application needs	Source context	RealtyCrawl contract
Resource identity	Source-scoped resource identifier	Source reference and RealtyCrawl ID
Operation data	Source-specific fields and units	Typed resource schemas and explicit missing values
Freshness	Collection and update times	Explicit observation timestamps
Missing information	Source-dependent attributes	Nullable fields and field_status
Coverage	Operation and market availability	Live capabilities and source outcomes
Diagnostics	Source warnings and errors	Request IDs and completeness metadata
Authentication	A request to RealtyCrawl	One API key across supported platforms

FAQ

Have a question?
We got answers

Find answers to common questions about the Geocodio API, credits, and coverage.

How do I start using the Geocodio API?

Get a RealtyCrawl API key, check Geocodio in /v1/meta/capabilities, and send a supported request from your backend with the x-api-key header.

Are all Geocodio operations available?

The catalog describes request contracts. Live enablement, accepted location selectors, and supported markets are declared per operation in /v1/meta/capabilities. Check the exact operation before running a workload.

How much does a Geocodio request cost?

Source requests cost 50 credits per successful call. Saved reads cost 1 credit per observation, including successful saved-batch items. Signup includes 500 trial credits. Failed calls are refunded. Read the credit headers for the charge and remaining balance.

Will every observation contain every field?

No. Data varies by source, market, and operation. Nullable fields and field_status distinguish missing, unsupported, restricted, and temporarily unavailable values. Keep response warnings with the result.

Is a stored observation a fresh source crawl?

Stored listing, media, and history observations expire after 24 hours and do not trigger a new crawl. Inspect observed_at, source_updated_at, and response metadata to understand the age of a record.

Is this an official Geocodio API?

RealtyCrawl is an independent data API and is not affiliated with Geocodio. Source availability and supported operations are declared in the capabilities endpoint.

Can I use the same key for another platform?

Yes. One RealtyCrawl API key authenticates supported operations across the catalog. Check capabilities when adding a platform because availability and accepted inputs vary.

Related APIs and tools

Explore more sources and build on the same RealtyCrawl integration.

All platforms Unified property schema Quickstart MCP server

Fetch Geocodio data with one API

What Geocodio endpoints does RealtyCrawl ship?

Resolve and normalize a street address

Read a retained normalized address

How the Geocodio API works

Authenticate every call

GET and POST requests

One credit system

JSON and data exports

The usual integration chain

What lands in data

Inside the gateway

Operation selection

Source collection

Contract normalization

Response metadata

Billing rules that make evaluation clear

How we get the data

What your request targets

How records are returned

What comes with each result

What an observation means

What this API
is used for

property workflows

What people build with the Geocodio API

Address normalization

Geographic enrichment

Use case examples

Search applications

Research pipelines

Assistant workflows

Make your first request

Same key as the rest of the catalog

What data does the Geocodio API return?

Resolve and normalize a street address

Read a retained normalized address

How does RealtyCrawl structure Geocodio data?

Have a question?
We got answers

Fetch Geocodio data with one API

What Geocodio endpoints does RealtyCrawl ship?

Resolve and normalize a street address

Read a retained normalized address

How the Geocodio API works

Authenticate every call

GET and POST requests

One credit system

JSON and data exports

The usual integration chain

What lands in data

Inside the gateway

Operation selection

Source collection

Contract normalization

Response metadata

Billing rules that make evaluation clear

How we get the data

What your request targets

How records are returned

What comes with each result

What an observation means

What this APIis used for

property workflows

What people build with the Geocodio API

Address normalization

Geographic enrichment

Use case examples

Search applications

Research pipelines

Assistant workflows

Make your first request

Same key as the rest of the catalog

What data does the Geocodio API return?

Resolve and normalize a street address

Read a retained normalized address

How does RealtyCrawl structure Geocodio data?

Have a question?We got answers

Related APIs and tools

What this API
is used for

Have a question?
We got answers