Skip to main content
POST
/
v1
/
marketplace
/
agents
Get Marketplace Agents
curl --request POST \
  --url https://api.swarms.world/v1/marketplace/agents \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "number_of_items": 10
}
'
{
  "prompts": [
    {
      "id": "<string>",
      "created_at": "<string>",
      "user_id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "prompt": "<string>",
      "use_cases": {},
      "status": "<string>",
      "tags": "<string>",
      "category": "<string>",
      "links": []
    }
  ],
  "total_count": 123,
  "status": "success",
  "timestamp": "2026-06-06T21:41:29.957625"
}

Headers

​
x-api-key
string
required

Body

application/json
​
number_of_items
integer | null
default:10

Number of items to return

Response

Successful Response

Response schema for marketplace prompts endpoint.

​
prompts
MarketplacePrompt · object[]
required

List of marketplace prompts

​
total_count
integer
required

Total number of prompts available

​
status
string | null
default:success

The status of the marketplace prompts response.

​
timestamp
string | null
default:2026-06-06T21:41:29.957625

The timestamp of the marketplace prompts response.