{"uid":"cap_cljoYgiMiABAbowt5wJur","slug":"padelmaps-org-6e0eeea3","name":"PadelMaps Geocoding API","description":"Convert address to coordinates","url":"https://padelmaps.org/api/x402-tools/geocode","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["address"],"properties":{"limit":{"type":"integer","description":"Max results (default 5, max 10)"},"address":{"type":"string","description":"Address or place name to geocode. Alias: 'query'. E.g. 'Eiffel Tower, Paris'"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"integer"},"query":{"type":"string"},"cached":{"type":"boolean"},"results":{"type":"array"}}}}}}},"responseSchema":null,"example":{"request":{"address":"1600 Amphitheatre Parkway, Mountain View, CA"},"response":{"count":2,"query":"1600 Amphitheatre Parkway, Mountain View, CA","cached":false,"results":[{"type":"commercial","address":{"city":"Mountain View","road":"Amphitheatre Parkway","state":"California","county":"Santa Clara County","country":"United States","building":"Google Building 41","postcode":"94043","country_code":"us","house_number":"1600","ISO3166-2-lvl4":"US-CA"},"latitude":37.4224858,"longitude":-122.0855846,"importance":0.00006277943083843774,"display_name":"Google Building 41, 1600, Amphitheatre Parkway, Mountain View, Santa Clara County, California, 94043, United States"},{"type":"it","address":{"city":"Mountain View","road":"Amphitheatre Parkway","state":"California","county":"Santa Clara County","office":"Google Headquarters","country":"United States","postcode":"94043","country_code":"us","house_number":"1600","ISO3166-2-lvl4":"US-CA"},"latitude":37.4217636,"longitude":-122.084614,"importance":0.00006277943083843774,"display_name":"Google Headquarters, 1600, Amphitheatre Parkway, Mountain View, Santa Clara County, California, 94043, United States"}]}},"exampleRequest":{"address":"1600 Amphitheatre Parkway, Mountain View, CA"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.90","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_E5eIYkPqAX9Q1qo3f41J0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a street address string into geographic coordinates (latitude/longitude) with structured address components and place metadata","exampleAgentPrompt":"What are the latitude and longitude coordinates for 1600 Amphitheatre Parkway, Mountain View, CA?","exampleUseCases":null,"resultDescription":"Returns a list of matching results for the address, each containing latitude, longitude, place type (e.g. 'commercial', 'it'), a human-readable display name, structured address fields (house number, road, city, county, state, postcode, country, country code), and an importance score indicating result confidence. Also returns the original query string and whether the result was served from cache.","failureModes":["Address not found or too ambiguous — returns empty results array","Malformed address input — may return zero results or low-confidence matches","Network timeout or service unavailability — HTTP 5xx error","Payment failure — x402 payment not accepted, returns 402 status","Missing required 'address' field in request body — returns 400 error"],"whenToPreferThis":"Use this endpoint when you need to convert a human-readable street address into geographic coordinates (latitude/longitude) for use in mapping, routing, or location-based queries. Prefer this over reverse geocoding endpoints when the input is an address string rather than coordinates. Cost is $0.01 USDC per call via x402 micropayment protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":21,"lastUsedAt":"2026-07-02T17:38:21.004Z","lastSuccessfullyRanAt":"2026-07-02T17:38:21.004Z","lastHealthCheckAt":"2026-09-15T06:30:21.081Z","isFirstParty":false}