{"uid":"cap_rox5Q3pHRzNU9uN9UOFIW","slug":"mapbox-geocoding-via-api-osk-gateway-06ad726e","name":"Mapbox Geocoding via API OSK Gateway","description":"API call to mapbox","url":"https://gateway.apiosk.com/mapbox/geocode","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"FeatureCollection","features":[{"id":"dXJuOm1ieHBsYzpFVzBJN0E","type":"Feature","geometry":{"type":"Point","coordinates":[-122.419359,37.779238]},"properties":{"name":"San Francisco","context":{"place":{"name":"San Francisco","mapbox_id":"dXJuOm1ieHBsYzpFVzBJN0E","wikidata_id":"Q62"},"region":{"name":"California","mapbox_id":"dXJuOm1ieHBsYzpCbVRz","region_code":"CA","wikidata_id":"Q99","region_code_full":"US-CA"},"country":{"name":"United States","mapbox_id":"dXJuOm1ieHBsYzpJdXc","wikidata_id":"Q30","country_code":"US","country_code_alpha_3":"USA"},"district":{"name":"San Francisco County","mapbox_id":"dXJuOm1ieHBsYzpBVG1HN0E","wikidata_id":"Q62"}},"mapbox_id":"dXJuOm1ieHBsYzpFVzBJN0E","coordinates":{"latitude":37.779238,"longitude":-122.419359},"feature_type":"place","full_address":"San Francisco, California, United States","name_preferred":"San Francisco","place_formatted":"California, United States"}}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.165","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.165/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.165","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.165","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kt_maW1b9_ZqQz0vnU0m3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.165","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a place name or address string into geographic coordinates and structured location metadata using Mapbox","exampleAgentPrompt":"What are the coordinates and full address breakdown for San Francisco? I need the latitude, longitude, region, country, and district.","exampleUseCases":null,"resultDescription":"Returns a GeoJSON FeatureCollection with one or more place features, each containing: coordinates (latitude/longitude), full address string, place name, region name and code, country name and code, district name, mapbox_id, and wikidata_id for the matched location.","failureModes":["Unrecognized or misspelled place name returns empty features array","Ambiguous location query may return unexpected top result","Missing or malformed query parameter returns error","Payment failure (x402) if USDC balance is insufficient","Rate limiting or gateway timeout on high-traffic periods"],"whenToPreferThis":"Use this endpoint when you need to geocode a place name or address into geographic coordinates and want rich structured metadata (region, country, district, wikidata IDs) in GeoJSON format. Prefer this over raw Mapbox API calls if you need pay-per-use billing via x402/USDC without managing Mapbox API keys directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T14:28:19.763Z","isFirstParty":false}