# Choose your SDK

Search from your server, browser or mobile app. Choose one of twelve SDKs and see exactly which surface it supports.

Canonical: https://searchsdk.dev/docs/sdks
Markdown: https://searchsdk.dev/docs/sdks.md

<a id="server-sdks"></a>

## Server SDKs

Use direct provider adapters for normalized web results, or a separate native client for provider-specific operations. The server SDKs cover 14 normalized adapters and 493 retained native operation bindings across 13 providers. Provider credentials stay in your server process.

- [TypeScript / JavaScript](https://searchsdk.dev/docs/sdks/typescript): Node 24.22.1+ within Node 24, or Node 26.12.1+ within Node 26. Direct provider APIs.
- [Python](https://searchsdk.dev/docs/sdks/python): Python 3.11+. Direct provider APIs.
- [Go](https://searchsdk.dev/docs/sdks/go): Go 1.23+. Direct provider APIs.
- [Java](https://searchsdk.dev/docs/sdks/java): Java 17+. Direct provider APIs.
- [Rust](https://searchsdk.dev/docs/sdks/rust): Rust / Cargo 1.98+. Direct provider APIs.
- [C# / .NET](https://searchsdk.dev/docs/sdks/dotnet): .NET 10. Direct provider APIs.
- [C](https://searchsdk.dev/docs/sdks/c): C11 / POSIX; libcurl 7.85+ for HTTPS. Direct provider APIs.
- [C++](https://searchsdk.dev/docs/sdks/cpp): C++17 over the C11 / POSIX ABI. Direct provider APIs.

<a id="app-sdks"></a>

## App SDKs

Swift, Android, React Native and Expo send normalized requests to your application's HTTPS gateway. They preserve sources, attempt metadata, deadlines and cancellation while keeping provider keys off the device. Expo also has a browser entry. Provider choice, fallback and native operations remain server-side.

- [Swift](https://searchsdk.dev/docs/sdks/swift): Swift 6 · iOS 16+ · macOS 13+ · tvOS 16+ · watchOS 9+ · visionOS 1+. Application gateway client.
- [Android / Kotlin](https://searchsdk.dev/docs/sdks/android): Android API 26+. Application gateway client.
- [React Native](https://searchsdk.dev/docs/sdks/react-native): React Native · iOS 15.1+ · Android API 24+. Application gateway client.
- [Expo](https://searchsdk.dev/docs/sdks/expo): Expo SDK 55–57 · native development builds and web. Application gateway client.

- [Build your application gateway](https://searchsdk.dev/docs/guides/application-gateway): Connect an app SDK to a server with explicit authorization.

<a id="availability"></a>

## Alpha availability

All twelve SDKs are alpha source packages. Install from a reviewed checkout or its locally built artifacts. Package names and versions describe those artifacts; they do not establish availability in npm, PyPI, Maven Central, crates.io, NuGet or a release tag. Alpha APIs may change. Record the source revision and retain your application's dependency lock.

**Get the source**

```bash
git clone https://github.com/Belweave/searchSDK.git
cd searchSDK
# Record this revision with your application's dependency lock.
git rev-parse HEAD
```

Follow the selected SDK's installation guide next. Each language uses its own toolchain; Node is required for the TypeScript/mobile JavaScript packages and repository tooling, not every SDK runtime.

<a id="shared-contract"></a>

## Shared contract, explicit differences

| Surface | What you can rely on |
| --- | --- |
| Normalized search | A bounded query/result contract, source provenance, provider order, explicit capabilities and sanitized errors. |
| Native clients | Provider-specific operation and wire models from retained public source tables and schemas. These bindings are not every upstream endpoint. |
| App gateway | Application-owned HTTPS, request-scoped application tokens, validated normalized responses and no automatic POST retries. |
| Language policy | Read the selected SDK's guide for async style, streaming, retry limits, caching and platform coverage. APIs and policies are not identical across languages. |

Valyu and SearXNG have normalized adapters; WonderSearch is native corpus retrieval. Use the provider catalog to choose a supported operation. Custom server adapters are the extension point for a provider that is not in the built-in set.

- [Provider capabilities](https://searchsdk.dev/docs/providers)
- [Extend provider support](https://searchsdk.dev/docs/api/providers#trust)

<a id="verification"></a>

## What has been verified

Each package includes deterministic tests and a consumer that uses its built artifact. The guides distinguish executed runtime checks from source/type or compilation checks. Fixtures and local HTTPS servers do not establish live provider availability, account access, pricing or retrieval quality.

- [Package verification and platform details](https://github.com/Belweave/searchSDK/tree/main/packages#readme)
- [Verification limits](https://searchsdk.dev/docs/reliability/verification)