Skip to main content
Fetch a list of publicly available agents from the Swarms Marketplace.
  • Endpoint: GET /v1/marketplace/agents
  • Auth: x-api-key header
  • Optional body: {"number_of_items": <int>} to limit results
  • Python
  • JavaScript
  • cURL
import json
import os

from dotenv import load_dotenv
from requests import get

load_dotenv()

API_KEY = os.getenv("SWARMS_API_KEY")

BASE_URL = "https://api.swarms.world"

headers = {"x-api-key": API_KEY, "Content-Type": "application/json"}

response = get(
    f"{BASE_URL}/v1/marketplace/agents",
    headers=headers,
    json={"number_of_items": 10},  # optional
)

print(f"Status Code: {response.status_code}")
out = response.json()
print(json.dumps(out, indent=4))
If your HTTP client or proxy rejects a body on GET, omit the JSON body or pass number_of_items via query string if supported by your environment.