REST endpoint. Bearer auth.
Ranked candidates as JSON.
AI geolocation API
Wire image-to-location into your claim system, content pipeline, investigation corpus, or e-discovery workflow. Ranked candidates with confidence scores, visual evidence array, model version stamp. Request reviewed API access for an evaluation or production integration. Credits and limits are scoped to the use case.
Send an image, get ranked locations
POST https://oceanir.ai/api/v1/geolocate
x-api-key: oceanir_...
{
"image_url": "https://example.com/photo.jpg"
}
200 OK
{
"top": {
"lat": 25.7617,
"lng": -80.1918,
"confidence": 0.94,
"address": "Little Havana, Miami, FL, USA"
},
"alternatives": [
{ "lat": 25.7505, "lng": -80.2659, "confidence": 0.87, "address": "Coral Gables, FL" },
{ "lat": 25.7682, "lng": -80.1907, "confidence": 0.81, "address": "Brickell, Miami, FL" }
],
"evidence": [
"Spanish-language storefront signage",
"Mid-century single-story commercial architecture",
"Specific palm species common to South Florida"
],
"model_version": "orca-1.4-20260415"
}Response shape illustrative. Live endpoint and current schema available in the dashboard once you provision an API key.
Four production integrations
Claim system integration
Wire the API as a step in claim ingestion. Run the visual signal at first notice of loss, route high-risk locations to SIU, fast-track in-zone claims to payment.
Content moderation
Verify location claims on user-generated photos and videos before they ship to a public feed. Flag mismatches between captioned location and visual signal.
Social listening
Geolocate images from monitored accounts, hashtags, or feeds at scale. Build location graphs across a corpus to spot operational patterns.
E-discovery and legal-tech
Wire the API into case management and review tooling. Auto-generate location candidates and forensic PDFs for image-bearing evidentiary documents.
Provision an API key
API keys are provisioned after a short integration review, with evaluation credits and limits scoped to your use case.
Contact usDeveloper questions about the API
A JSON response with the top-ranked location candidate (latitude, longitude, confidence score), up to two alternative candidates with their own scores, the visual cues that supported each ranking, contradicting signals where present, and a reproducibility identifier. The same image returns the same result on the same model version.
API access is included with Pro, serving Orca. Enterprise volume access is reviewed: contact Oceanir with your use case and production timeline; approved integrations receive scoped credits and limits.
Standard web image formats: JPEG, PNG, WebP, HEIC, and HEIF. Images are accepted as a binary upload or a public URL the API can fetch. Maximum dimension is generous enough for unmodified phone photos. Video frame analysis is available via a separate endpoint.
Rate limits are scoped during integration review. If your team needs higher throughput for batch reprocessing or backfill, include that volume in the access request.
Yes. A batch endpoint accepts a list of image references and returns ranked candidates per image. Useful for catastrophe-claim triage, social-media corpus analysis, and any workflow where you need to process more than ten images in one shot.
Approved integrations receive a provisioned key. Pass it as a Bearer token or x-api-key header on every request, and use the dashboard to view or revoke existing credentials.
Oceanir does not retain uploaded images after analysis completes. There is no shared training corpus from API submissions. The dashboard supports data deletion and export requests. For specific compliance attestations (SOC 2, ISO 27001, sector-specific certifications), contact sales.
Evaluation access does not include a contractual SLA. Production contracts can include a negotiated SLA, dedicated support, and optional region pinning for latency-sensitive workloads.