Skip to main content
GET https://swarms.world/api/product/list Returns every product the authenticated user has posted to the marketplace across agents, prompts, tools, and bundles. Each product includes its name, description, time posted, type, and public listing URL. Results are returned as a single flat list sorted newest-first, along with per-type counts. Authenticate with your Swarms API key in the Authorization header.

​
Request

​
Headers

NameTypeRequiredDescription
AuthorizationstringYesBearer YOUR_API_KEY. Get your key at swarms.world/platform/api-keys.

​
Query Parameters

ParameterTypeRequiredDescription
typestringNoRestrict results to a single product type. One of all (default), agent, prompt, tool, or bundle.

​
Response

​
Success (HTTP 200)

FieldTypeDescription
user_idstringThe authenticated user’s ID.
totalnumberTotal number of products returned.
countsobjectCount of products by type.
counts.agentsnumberNumber of agents.
counts.promptsnumberNumber of prompts.
counts.toolsnumberNumber of tools.
counts.bundlesnumberNumber of bundles.
productsarrayFlat list of products, sorted newest-first.
products[].idstringProduct ID (for bundles, the UUID used in the public URL).
products[].typestringagent, prompt, tool, or bundle.
products[].namestring | nullProduct name.
products[].descriptionstring | nullProduct description.
products[].created_atstringISO 8601 timestamp of when the product was posted.
products[].urlstringPublic listing URL on swarms.world.
Example success response: 
{
  "user_id": "6a5ca266-caff-46a5-8e29-fba2085e4e5f",
  "total": 3,
  "counts": {
    "agents": 1,
    "prompts": 1,
    "tools": 0,
    "bundles": 1
  },
  "products": [
    {
      "id": "f92f99fb-88fc-42f8-a8dc-d1b30973cf21",
      "type": "bundle",
      "name": "Medical Agent Suite",
      "description": "A comprehensive bundle of healthcare AI agents and prompts.",
      "created_at": "2026-06-18T14:10:58.392803+00:00",
      "url": "https://swarms.world/bundle/f92f99fb-88fc-42f8-a8dc-d1b30973cf21"
    },
    {
      "id": "8db782df-5634-4b39-b41f-d55890eca198",
      "type": "prompt",
      "name": "Book Distillation Agent",
      "description": "Transforms full-length books into information-dense reports.",
      "created_at": "2026-06-17T09:22:11.100000+00:00",
      "url": "https://swarms.world/prompt/8db782df-5634-4b39-b41f-d55890eca198"
    },
    {
      "id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "type": "agent",
      "name": "Research Analyst",
      "description": "Scans sources and produces structured research briefs.",
      "created_at": "2026-06-15T18:00:00.000000+00:00",
      "url": "https://swarms.world/agent/1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
    }
  ]
}

​
HTTP Status Codes

CodeMeaning
200Success.
401Unauthorized: API key is missing or invalid.
500Internal server error.

​
Example Request

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"

Product Fees API

Check creator fees generated by a tokenized product

Agents API

Create, update, and query agents

Prompts API

Create, update, and query prompts

API Overview

Quick reference for all Marketplace APIs