Skip to main content
The SDK is a good fit when you want to integrate ActionX directly into a frontend app and render results inside chat, recommendation, or content areas.

​
Minimal example

npm install @action-x/ad-sdk

import { AdManager } from "@action-x/ad-sdk";
import "@action-x/ad-sdk/style.css";

const manager = new AdManager({
  apiBaseUrl: "https://network.actionx.top/api/v1",
  apiKey: "ak_your_api_key",
});

await manager.requestAds({
  query: "Recommend a Bluetooth headset",
  response: "Here are a few good options for work and travel.",
});

manager.render(document.getElementById("ad-container"));

​
When to choose the SDK first

  • You want the frontend to control render position and presentation
  • Your application is a web frontend or frontend-led architecture
  • You want the shortest path to integration and validation

​
Continue reading

Full SDK guide

Explore fuller examples for React, Vue, and SDK event handling.

Universal SDK usage

Explore framework-agnostic and vanilla JavaScript integration patterns.