SDKs & CLI - SmartlyQ

Official client libraries for the SmartlyQ API. Every SDK covers the full API surface - social posting and scheduling, AI content generation (articles, images, video, audio, presentations), SEO research, CRM, chatbots, profiles, workspaces, and more - with the same resource-based method names in every language. All SDKs are generated from the OpenAPI spec and republish automatically when the API gains new endpoints, so they are never behind the API Reference.

Official SDKs

Node.js

npm install @smartlyqofficial/nodeTypeScript types for every request and response. Zero dependencies, native fetch, Node 18+.

Python

pip install smartlyqClean snake_case client on httpx. Context-manager friendly, Python 3.9+.

Go

go get github.com/SmartlyQ/smartlyq-goContext-first, standard library only, zero dependencies. Go 1.22+.

PHP

composer require smartlyq/sdkPSR-4, zero runtime dependencies, PHP 8.1+.

CLI

npm install -g @smartlyqofficial/cliEvery API operation as a shell command - perfect for scripts, cron jobs, and CI.

Chat SDK Adapter

npm install @smartlyqofficial/chat-sdk-adapterBuild a multi-platform chatbot on the unified inbox. Write once - works on every connected platform.

One surface, every language

The method names mirror each other across every SDK - learn it once, use it anywhere:

import SmartlyQ from '@smartlyqofficial/node';

const sq = new SmartlyQ({ apiKey: process.env.SMARTLYQ_API_KEY });

const post = await sq.social.createPost({
  text: 'Hello from SmartlyQ!',
  account_ids: ['acc_123'],
});

from smartlyq import SmartlyQ

sq = SmartlyQ()  # reads SMARTLYQ_API_KEY

post = sq.social.create_post({
    "text": "Hello from SmartlyQ!",
    "account_ids": ["acc_123"],
})

client := smartlyq.NewClient("") // reads SMARTLYQ_API_KEY

post, err := client.Social.CreatePost(ctx, map[string]any{
	"text":        "Hello from SmartlyQ!",
	"account_ids": []string{"acc_123"},
}, nil)

$sq = new Smartlyq\SmartlyQ(); // reads SMARTLYQ_API_KEY

$post = $sq->social->createPost([
    'text' => 'Hello from SmartlyQ!',
    'account_ids' => ['acc_123'],
]);

smartlyq social create-post \
  --data '{"text":"Hello from SmartlyQ!","account_ids":["acc_123"]}'

Building an AI agent instead?

MCP Server

The hosted Model Context Protocol server exposes the same API as tools for Claude, Cursor, ChatGPT, and any MCP client - usually the fastest integration for agents. The SDKs are the right choice when you are writing code.

Shared behavior

Every SDK ships the same batteries:

Authentication via Authorization: Bearer sqk_live_... - pass the key to the constructor or set the SMARTLYQ_API_KEY environment variable.
Automatic retries with exponential backoff on 429 and 5xx, honoring Retry-After.
Idempotency keys for safely retrying writes.
Profile scoping - act on behalf of a managed Profile by setting the profile option (sent as X-Profile-Id).
Typed errors carrying the HTTP status, error code, message, and request_id for support.
Sandbox keys (sqk_test_...) work everywhere - simulated responses, no charges.

​Official SDKs