GeoBit AI — Python SDK

Python client for the GeoBit AI geospatial intelligence API.

Install

pip install geobit

Quick Start

from geobit import GeobitClient

client = GeobitClient(api_key="geobit_v1_...")

# Health check
client.health()

# Search conflicts in a country
results = client.intelligence.conflicts_search(country="Ukraine", time_range="30d")

# GDELT event search
events = client.intelligence.gdelt_events(countries=["SY", "IQ"], days=7)

# Web search with automatic geocoding
hits = client.search.web(query="military buildup near Kherson")

# Early warning alerts
alerts = client.ews.alerts(country="Sudan")

# Conflict prediction
prediction = client.ews.prediction(country="Myanmar")

# Internet connectivity monitoring
status = client.ews.connectivity(country="Ethiopia")

# Multi-source intelligence fusion
intel = client.fusion.intelligence(days_back=7)

# Real-time aircraft tracking
planes = client.flight.aircraft(bbox=[33.0, 38.0, 35.0, 45.0])

# Weather grid
weather = client.weather.grid(lat=6.5, lng=3.4, radius_km=50)

Namespaces

Authentication

All requests require an API key passed via the X-API-Key header (handled automatically).

client = GeobitClient(api_key="geobit_v1_...")

Error Handling

from geobit import GeobitClient, AuthenticationError, InsufficientCreditsError

client = GeobitClient(api_key="geobit_v1_...")

try:
    results = client.intelligence.conflicts_search(country="Nigeria")
except AuthenticationError:
    print("Invalid API key")
except InsufficientCreditsError as e:
    print(f"Need more credits: {e.details}")

API Docs

Full API documentation with Swagger UI: https://api.geobit.ai/api/v1/docs