{"uid":"cap_2V04LjKYJm3ti7o7xJFoU","slug":"1gateway-satellite-imagery-sentinel-2-b1484cbc","name":"1gateway Satellite Imagery (Sentinel-2)","description":"Use when an agent must see a place from above or check vegetation, water or change. Input: lat, lon, radius_m (200-10000), mode (true_color, false_color, ndvi, ndwi, moisture), date, days back, max_cloud. Picks the clearest Sentinel-2 scene by cloud share inside your area, not the whole tile. Output: JSON PNG URL (+ other modes), scene date, area cloud %, alternatives. No scene: 404, not charged. Example: ?lat=37.5665&lon=126.978","url":"https://1gateway.dev/v1/geo/satellite?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":["lat","lon"],"properties":{"lat":{"type":"number","maximum":84,"minimum":-84,"examples":[37.5665],"description":"Latitude, WGS84 decimal degrees"},"lon":{"type":"number","maximum":180,"minimum":-180,"examples":[126.978],"description":"Longitude, WGS84 decimal degrees"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","examples":["2026-10-18"],"description":"Latest acceptable scene date YYYY-MM-DD (default today; 2017-01-01 or later)"},"days":{"type":"integer","maximum":90,"minimum":1,"examples":[30],"description":"Look-back window in days before date (default 30)"},"mode":{"enum":["true_color","false_color","ndvi","ndwi","moisture"],"type":"string","examples":["true_color"],"description":"Rendering (default true_color); URLs for the other modes are returned too"},"size":{"type":"integer","maximum":2048,"minimum":256,"examples":[1024],"description":"Image width/height in px (default 1024)"},"radius_m":{"type":"integer","maximum":10000,"minimum":200,"examples":[3000],"description":"Half-width of the square area in meters (default 2000)"},"max_cloud":{"type":"number","maximum":100,"minimum":0,"examples":[40],"description":"Target max cloud % inside the area (default 40); if no scene meets it the clearest is returned with fulfillment=best_available"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["location","request","fulfillment","scene","image","otherModes","alternatives","scenesConsidered","attribution","note"],"properties":{"note":{"type":"string"},"image":{"type":"object","properties":{"url":{"type":"string"},"mode":{"type":"string"},"format":{"type":"string"},"widthPx":{"type":"integer"},"heightPx":{"type":"integer"},"description":{"type":"string"},"groundResolutionM":{"type":"number"},"nativeResolutionM":{"type":"integer"}}},"scene":{"type":"object","properties":{"id":{"type":"string"},"area":{"type":"object","properties":{"snowPct":{"type":"number"},"clearPct":{"type":"number"},"cloudPct":{"type":"number"},"noDataPct":{"type":"number"},"shadowPct":{"type":"number"}}},"date":{"type":"string"},"datetime":{"type":"string"},"mgrsTile":{"type":["string","null"]},"platform":{"type":["string","null"]},"tileCloudPct":{"type":"number"}}},"request":{"type":"object","properties":{"date":{"type":"string"},"days":{"type":"integer"},"from":{"type":"string"},"mode":{"type":"string"},"size":{"type":"integer"},"maxCloudPct":{"type":"number"}}},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"bbox":{"type":"array","items":{"type":"number"}},"radiusM":{"type":"integer"}}},"otherModes":{"type":"object","properties":{"ndvi":{"type":"string"},"ndwi":{"type":"string"},"moisture":{"type":"string"},"true_color":{"type":"string"},"false_color":{"type":"string"}}},"attribution":{"type":"string"},"fulfillment":{"type":"string"},"alternatives":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"area":{"type":"object","properties":{"snowPct":{"type":"number"},"clearPct":{"type":"number"},"cloudPct":{"type":"number"},"noDataPct":{"type":"number"},"shadowPct":{"type":"number"}}},"date":{"type":"string"},"datetime":{"type":"string"},"mgrsTile":{"type":["string","null"]},"platform":{"type":["string","null"]},"tileCloudPct":{"type":"number"}}}},"scenesConsidered":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"note":"Scene chosen by cloud/shadow share inside the requested area (Sentinel-2 SCL), not the tile-wide cloud figure. Image URLs render on request at Planetary Comput…","image":{"url":"https://planetarycomputer.microsoft.com/api/data/v1/item/bbox/126.944,37.5396,127.012,37.5934/1024x1024.png?collection=sentinel-2-l2a&item=S2B_MSIL2A_20261008T…","mode":"true_color","format":"png","widthPx":1024,"heightPx":1024,"description":"True color (B4/B3/B2)","groundResolutionM":5.9,"nativeResolutionM":10},"scene":{"id":"S2B_MSIL2A_20261008T021559_R003_T52SCG_20261008T042548","area":{"snowPct":0,"clearPct":100,"cloudPct":0,"noDataPct":0,"shadowPct":0},"date":"2026-10-08","datetime":"2026-10-08T02:15:59.024000Z","mgrsTile":"52SCG","platform":"Sentinel-2B","tileCloudPct":0},"request":{"date":"2026-10-18","days":30,"from":"2026-09-19","mode":"true_color","size":1024,"maxCloudPct":40},"location":{"lat":37.5665,"lon":126.978,"bbox":[126.944],"radiusM":3000},"otherModes":{"ndvi":"https://planetarycomputer.microsoft.com/api/data/v1/item/bbox/126.944,37.5396,127.012,37.5934/1024x1024.png?collection=sentinel-2-l2a&item=S2B_MSIL2A_20261008T…","ndwi":"https://planetarycomputer.microsoft.com/api/data/v1/item/bbox/126.944,37.5396,127.012,37.5934/1024x1024.png?collection=sentinel-2-l2a&item=S2B_MSIL2A_20261008T…","moisture":"https://planetarycomputer.microsoft.com/api/data/v1/item/bbox/126.944,37.5396,127.012,37.5934/1024x1024.png?collection=sentinel-2-l2a&item=S2B_MSIL2A_20261008T…","false_color":"https://planetarycomputer.microsoft.com/api/data/v1/item/bbox/126.944,37.5396,127.012,37.5934/1024x1024.png?collection=sentinel-2-l2a&item=S2B_MSIL2A_20261008T…"},"attribution":"Contains modified Copernicus Sentinel data (ESA). Imagery served by Microsoft Planetary Computer.","fulfillment":"exact","alternatives":[{"id":"S2C_MSIL2A_20260923T021531_R003_T52SCG_20260923T054616","url":"https://planetarycomputer.microsoft.com/api/data/v1/item/bbox/126.944,37.5396,127.012,37.5934/1024x1024.png?collection=sentinel-2-l2a&item=S2C_MSIL2A_20260923T…","area":{"snowPct":0,"clearPct":83.5,"cloudPct":14.8,"noDataPct":0,"shadowPct":1.8},"date":"2026-09-23","datetime":"2026-09-23T02:15:31.025000Z","mgrsTile":"52SCG","platform":"Sentinel-2C","tileCloudPct":14.9}],"scenesConsidered":3}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.009","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.009/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.009","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QVcyc9cxg8VV_VmJ6w1AH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.009","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the clearest Sentinel-2 satellite image for a given location and radius, with cloud filtering and multi-spectral modes (true color, NDVI, NDWI, moisture, false color).","exampleAgentPrompt":"Can you get me a clear Sentinel-2 satellite image of Seoul (37.5665, 126.978) from the last 30 days in true color, with a 3000 meter radius and max 40% cloud cover?","exampleUseCases":[{"title":"Crop health NDVI check","prompt":"Get me an NDVI satellite image centered on lat 35.1234, lon 128.5678 with a 5000 meter radius, looking back 60 days, so I can assess how healthy the vegetation is on this farmland."},{"title":"Flood extent water detection","prompt":"I need an NDWI satellite view of the area around lat 13.756, lon 100.502 with a 10000 meter radius from the last 14 days — I want to see how much water is covering the land after the recent flooding."},{"title":"Urban construction site monitoring","prompt":"Pull me a false color Sentinel-2 image of the construction zone near lat 51.505, lon -0.09 in London, 2000 meter radius, within the last 30 days, keeping cloud cover under 20%."}],"resultDescription":"A JSON response containing: a PNG image URL for the requested mode, the exact scene ID and date, per-area cloud/shadow/snow/clear percentages, ground resolution in meters, URLs for all other spectral modes (true_color, false_color, ndvi, ndwi, moisture), a list of alternative scenes considered, fulfillment status (exact or best_available), bounding box coordinates, and attribution text. Returns 404 (not charged) if no scene is found.","failureModes":["404 returned (no charge) when no Sentinel-2 scene exists for the requested area and date range","fulfillment=best_available when no scene meets max_cloud threshold — clearest available is returned instead","Truncated or partial bounding box if radius_m pushes outside valid tile coverage","Invalid lat/lon range (lat must be -84 to 84, lon -180 to 180) returns validation error","date before 2017-01-01 rejected as Sentinel-2 archive does not extend earlier","radius_m outside 200–10000 meter range returns schema validation error"],"whenToPreferThis":"Choose this endpoint when you need cloud-filtered, area-specific Sentinel-2 satellite imagery rather than tile-wide scenes. It is ideal for vegetation (NDVI), water (NDWI), moisture, or visual inspection of a precise geographic area. Prefer it over generic satellite tile services when you need per-area cloud quality selection, multi-spectral mode URLs in one response, and pay-per-use pricing with no charge on empty results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T13:19:19.313Z","isFirstParty":false,"canonicalSlug":"1gateway-satellite-imagery-sentinel-2-b1484cbc"}