{"uid":"cap_vhOU0XBfDY7ey6bAQG28m","slug":"agentsvc-io-postal-code-lookup-66d54b4c","name":"agentsvc.io Postal Code Lookup","description":"86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.","url":"https://agentsvc.io/api/v1/proxy/postal-code?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string","description":"State abbreviation, required with city"},"country":{"type":"string","description":"ISO 3166-1 alpha-2"},"postal_code":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"found":true,"places":[{"lat":48.1345,"lon":11.571,"place":"München","state":"Bayern","state_code":"BY"}],"source":"zippopotam.us (GeoNames)","country":"DE","postal_code":"80331"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4zM2nEH-6L7s9yrwOSgA2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up geographic details (place name, state, coordinates) for a postal code or city/state combination, supporting international queries via ISO country codes.","exampleAgentPrompt":"What's the postal code and coordinates for München, Bavaria, Germany? I need the place details including latitude and longitude.","exampleUseCases":[{"title":"Validate shipping address postal code","prompt":"I need to confirm that postal code 80331 is a real place in Germany and find out what city and region it maps to before I ship this package."},{"title":"Enrich user profile with location data","prompt":"A user signed up with city 'Austin' and state 'TX' in the US — can you look up their zip code and coordinates so I can store their full location info?"},{"title":"Reverse-look up place name from foreign postcode","prompt":"I have the postal code SW1A 1AA for the UK — what city and region does it belong to, and what are the coordinates?"}],"resultDescription":"Returns a JSON object with a 'found' boolean, a 'places' array containing objects with latitude, longitude, place name, state, and state code, plus the source data attribution, country code, and the queried postal code.","failureModes":["Postal code not found in GeoNames database — returns found: false with empty places array","Invalid or unsupported country code — may return not found or error","Missing required field combination (e.g. city without state for US) — may return ambiguous or no results","Network timeout or upstream GeoNames outage — service error response","Malformed input (non-string types) — validation error"],"whenToPreferThis":"Use this endpoint when you need lightweight, pay-per-call postal code resolution without managing API keys or subscriptions — ideal for agents enriching address data, validating postal codes, or geocoding city/state inputs internationally. Prefer this over full geocoding APIs when you only need postal-level granularity and want zero-setup USDC micropayment billing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:42:13.410Z","isFirstParty":false,"canonicalSlug":"agentsvc-io-postal-code-lookup-66d54b4c"}