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.
Developer CLI (API key required). Agents should use MCP, not REST or the CLI.
Create a key in the developer console. No sales form for Pro and above.
Short agent index. Agents use MCP; REST is a keyed developer integration.