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. Start with one free API key and 3 trial credits. Successful calls are pay as you go at $0.80 per credit before pack discounts.
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
No subscription is required. Create a key for free, use 3 trial credits, then buy credits only when you need more calls.
Create a free API keyDeveloper 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.
No subscription is required. Sign in to create one API key and receive 3 trial credits. Successful calls then consume prepaid credits at $0.80 per credit before pack discounts. Enterprise contracts are available for higher throughput and negotiated billing.
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.
Self-serve API keys allow 10 requests per minute and 100 requests per hour. Credits cap billable usage. If your team needs higher throughput for batch reprocessing or backfill, contact sales for an enterprise contract.
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.
API keys are issued from the dashboard. Pass the key as a Bearer token in the Authorization header on every request. Keys can be rotated and scoped from the dashboard without contacting support.
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.
The self-serve API does not include a contractual SLA. Enterprise contracts can include a negotiated SLA, dedicated support, and optional region pinning for latency-sensitive workloads.