SDKs

Current Status

MaxSocials does not yet ship official SDKs for any language. The REST API is stable and well-documented; community contributions are welcome. Until official libraries are available, the recommended path is a thin wrapper around the REST API in your stack of choice; both patterns below take fewer than ten lines.

Calling the REST API Today

The REST API uses standard HTTP with JSON request and response bodies. Authentication is via a bearer token set in the Authorization header. See API Authentication for how to obtain a token, and REST API Reference for the full endpoint and schema catalogue.

TypeScript / Node.js: minimal fetch wrapper

// maxsocials-client.ts
const BASE = "https://api.maxsocials.com/v1";

export async function apiRequest<T>(
  path: string,
  init?: RequestInit,
): Promise<T> {
  const res = await fetch(`${BASE}${path}`, {
    ...init,
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.MAXSOCIALS_API_KEY}`,
      ...init?.headers,
    },
  });
  if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
  return res.json() as Promise<T>;
}

There is no published @maxsocials/types package yet. Until the official SDK ships, TypeScript users can hand-roll interfaces directly from the response shapes documented on the REST API Reference page. All resource shapes are documented there with full field descriptions; copying them into a local types/maxsocials.ts file is a reliable approach that gives you type safety with zero external dependencies.

Python: minimal requests wrapper

# maxsocials_client.py
import os, requests

BASE = "https://api.maxsocials.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['MAXSOCIALS_API_KEY']}"}

def api_request(path: str, method: str = "GET", **kwargs):
    resp = requests.request(method, BASE + path, headers=HEADERS, **kwargs)
    resp.raise_for_status()
    return resp.json()

Both wrappers handle authentication and error propagation. Extend with retry logic, pagination helpers, or request signing as your integration matures.

SDK Roadmap

Official, versioned SDK packages are on the product roadmap. The planned release sequence is:

• Node.js / TypeScript SDK, targeted Q3 2026. Will include generated TypeScript types, pagination iterators, and webhook signature verification utilities.
• Python SDK, to follow the Node.js release. Will cover the same surface area plus async support via httpx.
• Go SDK, planned after Python; timeline dependent on demand signals from the community.

No alpha or beta packages exist at this time. Announced timelines are targets, not guarantees.

Community Contributions

If you have built a wrapper library, want to propose a new SDK, or want to contribute to an official one when development opens, file a proposal or start a discussion at maxsocials.com/contact. We track SDK requests to inform prioritisation; the more use cases documented, the sooner a language moves up the roadmap.

Community-maintained libraries are welcome and will be listed on this page once they reach a stable release. Zylver Solutions will not endorse specific third-party packages but will link to them with a clearly labelled community attribution.