SDKs & Libraries

SDKs & Client Libraries

Official client libraries for integrating BigDataCloud APIs into your projects. All libraries are open source and available on GitHub.

Node.js & TypeScript

Node.js SDK

Node.jsServer-side

Official TypeScript-first SDK for all BigDataCloud APIs. Strongly-typed models for all 26 endpoints across IP Geolocation, Reverse Geocoding, Phone & Email Verification, and Network Engineering. Dual ESM/CJS build, native fetch, zero runtime dependencies.

$npm install bigdatacloud
GitHub npm

React Native Client

React NativeClient-side

Official React Native client for reverse geocoding and roaming detection. GPS-first via expo-location or bare RN Geolocation. Works on iOS and Android. No API key needed.

$npm install @bigdatacloudapi/react-native-client
GitHub npm

React Reverse Geocoding

ReactClient-side

React hook for free client-side reverse geocoding. GPS coordinates to city/country with automatic IP fallback. No API key needed.

$npm install @bigdatacloudapi/react-reverse-geocode-client
GitHub npm

Vue Reverse Geocoding

VueClient-side

Vue 3 composable for free client-side reverse geocoding. GPS coordinates to city/country with automatic IP fallback. No API key needed.

$npm install @bigdatacloudapi/vue-reverse-geocode-client
GitHub npm

JavaScript Reverse Geocoding

JavaScriptClient-side

Lightweight vanilla JS client for free client-side reverse geocoding. Zero dependencies, works in any browser environment. No API key needed.

$npm install bigdatacloud-reverse-geocode-client
GitHub npm

Python

Python SDK

PythonServer-side

Official Python SDK for all BigDataCloud APIs. Strongly-typed dataclass models, async-capable via httpx, and a GraphQL client with fluent query builders. Covers all 26 endpoints across all 4 API packages.

$pip install bigdatacloud
GitHub PyPI

PHP

PHP SDK

PHPServer-side

Official PHP SDK for all BigDataCloud APIs. Strongly-typed models using PHP 8.1+ readonly properties. Compatible with Laravel, Symfony, and any PHP 8.1+ project. Zero external dependencies — ext-curl only.

$composer require bigdatacloudapi/bigdatacloud
GitHub Packagist

.NET & C#

.NET SDK

.NETServer-side

Official .NET SDK for all BigDataCloud APIs. Strongly-typed models, async/await throughout, GraphQL client with typed query builders, and a ConfidenceAreaHelper for multi-polygon confidence areas. Targets netstandard2.0.

$dotnet add package BigDataCloud
GitHub NuGet

Java

Java SDK

JavaServer-side

Official Java SDK for all BigDataCloud APIs. Strongly-typed models, Java 11+ HttpClient (no extra HTTP library needed), and thread-safe design. Compatible with Kotlin and Android projects via Maven or Gradle.

$implementation 'com.bigdatacloud:bigdatacloud:1.0.0'
GitHub GitHub

Go

Go SDK

GoServer-side

Official Go SDK for all BigDataCloud APIs. Strongly-typed structs, context-aware requests, and a SplitIntoPolygons helper for multi-polygon confidence areas. Zero external dependencies — stdlib net/http only.

$go get github.com/bigdatacloudapi/bigdatacloud-go
GitHub pkg.go.dev

Ruby

Ruby SDK

RubyServer-side

Official Ruby SDK for all BigDataCloud APIs. Idiomatic Ruby with snake_case accessors, strongly-typed response models, and a ConfidenceArea helper for multi-polygon areas. Zero external dependencies — stdlib net/http only.

$gem install bigdatacloud
GitHub RubyGems

Rust

Rust SDK

RustServer-side

Official Rust SDK for all BigDataCloud APIs. Strongly-typed models with serde, Clone-safe client sharing a reqwest connection pool, and a split_into_polygons helper for confidence area polygons. MSRV 1.70.

$cargo add bigdatacloud
GitHub crates.io

Mobile

Kotlin/Android Client

KotlinClient-side

Official Kotlin client for Android — free reverse geocoding and roaming detection. GPS-first via FusedLocationProviderClient with automatic IP fallback. No API key needed.

$implementation('com.bigdatacloud:bigdatacloud-client:1.0.0')
GitHub GitHub

Swift Client

SwiftClient-side

Official Swift client for free reverse geocoding and roaming detection. GPS-first with automatic IP fallback. Works on iOS, macOS, tvOS and watchOS. No API key needed.

SPMhttps://github.com/bigdatacloudapi/bigdatacloud-swift-client
GitHub Swift Package Index

Flutter / Dart

FlutterClient-side

Flutter package for free client-side reverse geocoding. GPS coordinates to city/country with automatic IP fallback. No API key needed.

$flutter pub add bigdatacloud_reverse_geocode_client
GitHub pub.dev

AI & MCP

MCP Server

MCPServer-side

BigDataCloud as an MCP server for AI assistants. Connect Claude, Cursor, VS Code, and any MCP-compatible tool directly to BigDataCloud APIs.

$npx -y @bigdatacloudapi/mcp-server
GitHub npm
GraphQL