List Products API

curl -X GET "https://swarms.world/api/product/list" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filter to a single type
curl -X GET "https://swarms.world/api/product/list?type=bundle" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

BASE_URL = "https://swarms.world"
API_KEY = "YOUR_API_KEY"

response = requests.get(
    f"{BASE_URL}/api/product/list",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"type": "all"},  # all | agent | prompt | tool | bundle
    timeout=30,
)

data = response.json()
if response.ok:
    print(f"Total products: {data['total']}")
    print(f"Counts: {data['counts']}")
    for p in data["products"]:
        print(f"[{p['type']}] {p['name']} - posted {p['created_at']}")
        print(f"    {p['url']}")
else:
    print("Error:", data.get("error", response.text))

interface Product {
  id: string;
  type: "agent" | "prompt" | "tool" | "bundle";
  name: string | null;
  description: string | null;
  created_at: string;
  url: string;
}

interface ListProductsResponse {
  user_id: string;
  total: number;
  counts: {
    agents: number;
    prompts: number;
    tools: number;
    bundles: number;
  };
  products: Product[];
}

async function listProducts(
  apiKey: string,
  type: string = "all"
): Promise<ListProductsResponse> {
  const url = new URL("https://swarms.world/api/product/list");
  url.searchParams.set("type", type);

  const response = await fetch(url.toString(), {
    method: "GET",
    headers: { Authorization: `Bearer ${apiKey}` },
  });

  const data = await response.json();
  if (!response.ok) {
    throw new Error(data.error || "Unknown error");
  }
  return data as ListProductsResponse;
}

// Usage
listProducts("YOUR_API_KEY").then((data) => {
  console.log(`Total products: ${data.total}`);
  for (const p of data.products) {
    console.log(`[${p.type}] ${p.name} - ${p.url}`);
  }
});