SDKs & Libraries | Docs

GENYS provides official SDKs for the most popular programming languages. These libraries handle authentication, request formatting, error handling, and pagination — so you can focus on your integration logic.

Node.js

npm install @genys/sdk

import { GENYS } from '@genys/sdk';

const genys = new GENYS({ apiKey: process.env.GENYS_API_KEY });

// List campaigns
const campaigns = await genys.campaigns.list({ status: 'active' });

// Generate creative
const creative = await genys.creative.generate({
  prompt: 'Hero banner for summer sale, lifestyle photography',
  format: 'meta_feed',
  brandProfile: 'default',
});

Python

pip install genys

from genys import GENYS

genys = GENYS(api_key=os.environ["GENYS_API_KEY"])

# List campaigns
campaigns = genys.campaigns.list(status="active")

# Get analytics
metrics = genys.analytics.query(
    start_date="2026-03-01",
    end_date="2026-03-15",
    metrics=["spend", "conversions", "roas"],
    group_by="channel",
)

Go

go get github.com/genys-ai/genys-go

package main

import (
    "context"
    genys "github.com/genys-ai/genys-go"
)

func main() {
    client := genys.NewClient(genys.WithAPIKey(os.Getenv("GENYS_API_KEY")))

    campaigns, err := client.Campaigns.List(context.Background(), &genys.ListParams{
        Status: "active",
    })
}

SDK features

Automatic retry with exponential backoff for transient errors
Built-in pagination helpers (iterate over all results without manual cursor management)
Type-safe request and response objects
Webhook signature verification utilities
Comprehensive error types with actionable messages