{"uid":"cap_xTBoVwDe40qqh26iGvol5","slug":"us-address-geocoder-a85f62b2","name":"US Address Geocoder","description":"Geocode a US street address: normalized address, latitude and longitude, state, county and tract codes, with match quality.","url":"https://geo-us.x402tookit.com/geocode-address?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"US street address with city and state or ZIP"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"place":{"type":["null","string"]},"county":{"type":["null","string"]},"source":{"type":["null","string"]},"matches":{"type":["null","number"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"latitude":{"type":["null","number"]},"longitude":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"stateFips":{"type":["null","string"]},"components":{"type":["null","object"],"properties":{"zip":{"type":["null","string"]},"city":{"type":["null","string"]},"state":{"type":["null","string"]},"number":{"type":["null","string"]},"street":{"type":["null","string"]}}},"countyFips":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"tractGeoid":{"type":["null","string"]},"matchedAddress":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_61oeBh5MteIMbtBFYxsAU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Geocodes a US street address to normalized address, latitude/longitude, state/county/tract FIPS codes, and match quality metadata.","exampleAgentPrompt":"Can you geocode 1600 Pennsylvania Avenue NW, Washington, DC 20500 and give me the latitude, longitude, and census tract FIPS code?","exampleUseCases":[{"title":"Mapping customer delivery addresses","prompt":"I have a customer address — 742 Evergreen Terrace, Springfield, IL 62701 — can you geocode it and give me the lat/lon coordinates plus the county FIPS code so I can plot it on a map?"},{"title":"Enriching records with census geography","prompt":"I need to enrich our database record for 350 Fifth Avenue, New York, NY 10118 with its census tract GEOID, state FIPS, and county FIPS codes for a demographic analysis project."},{"title":"Verifying and normalizing a submitted address","prompt":"A user submitted '1 Infinite Loop, Cupertino CA' — can you geocode it, return the normalized address, and tell me the match quality so I know if it resolved correctly?"}],"resultDescription":"Returns a normalized matched address, latitude and longitude, state FIPS code, county FIPS code, census tract GEOID, parsed address components (street number, street, city, state, ZIP), match verdict and quality indicators (number of matches, degraded flag, reasons), data source URL, and a summary string. Null values are returned for fields that could not be resolved.","failureModes":["Address not found or unrecognizable — returns null coordinates and a non-match verdict","Ambiguous address with multiple matches — returns the top match with a degraded flag and match count > 1","Missing city/state or ZIP — query may fail validation or return low-confidence results","Non-US address supplied — out of scope, likely returns null or error","Misspelled street name — may still match with degraded quality or fail entirely"],"whenToPreferThis":"Choose this endpoint when you need authoritative US address geocoding combined with census geography identifiers (state FIPS, county FIPS, tract GEOID) in a single call. It is ideal for compliance, demographic enrichment, or mapping workflows where census tract context matters alongside coordinates. Prefer it over generic geocoding APIs when you specifically need US Census-aligned geographic codes or normalized address components with match quality signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T10:19:17.460Z","isFirstParty":false,"canonicalSlug":"us-address-geocoder-a85f62b2"}