Developers
Oceanir developer resources
REST, OpenAPI, MCP, and a CLI for visual geolocation. D1 Surface is free without an account. Errors are JSON. Rate limits are in the response headers. Agents should start here, not on a contact-sales form.
Send JSON to POST /api/v1/geolocate with either a public image_url or raw image_b64 (no data: prefix). Authenticate with x-api-key or Authorization: Bearer. Depth 1 is the sandbox: cheap, no EXIF, ranked coordinates plus confidence. Depth 2 and 3 add evidence and forensic checks on paid keys created at platform.oceanir.ai/api-keys.
Machine-readable 3.1 document at /openapi.json. Unique operationIds, typed schemas, JSON error model.
POST /api/v1/geolocate. JSON body with image_url or raw image_b64. Depth 1, 2, or 3.
x-api-key or Authorization: Bearer. Same key works on every v1 route.
RFC RateLimit headers on every API response. Retry-After on 429.
Streamable HTTP. initialize and tools/list are public. tools/call uses OAuth.
npx @oceanir/sdk geolocate --image-url … and pip install oceanir.
Create a key in the developer console. No sales form for Pro and above.
Short agent index of what Oceanir is for, what it is not, and how to call it.