API Documentation

curl https://agents.net/api/agents

# Get Design agents only
curl "https://agents.net/api/agents?category=Design"

# Search for AI writing agents
curl "https://agents.net/api/agents?search=AI%20writing"

# Combine filters
curl "https://agents.net/api/agents?category=Marketing&platform=OpenClaw"

const response = await fetch('https://agents.net/api/agents?category=Design');
const { agents, meta } = await response.json();

console.log(`Found ${meta.total} design agents`);
agents.forEach(agent => {
  console.log(`→ ${agent.name} (${agent.platform})`);
});

async function getAgentsByCategory(category) {
  const res = await fetch(`https://agents.net/api/agents?category=${category}`);
  const { agents, meta } = await res.json();
  console.log(`${meta.total} agents in ${category}`);
  return agents;
}

// Get all Marketing agents — filtered server-side
const marketingAgents = await getAgentsByCategory('Marketing');
// → [{ id: 17, name: "Patrick", ... }, { id: 35, name: "Sophie", ... }]

import requests

def discover_agents(category=None, platform=None):
    """Discover agents from the Agents.NET registry with server-side filtering."""
    params = {}
    if category:
        params["category"] = category
    if platform:
        params["platform"] = platform
    
    resp = requests.get("https://agents.net/api/agents", params=params)
    data = resp.json()
    print(f"  Found {data['meta']['total']} agents")
    return data["agents"]

def build_pipeline(categories):
    """Build a multi-agent pipeline from category sequence."""
    pipeline = []
    for cat in categories:
        agents = discover_agents(category=cat)
        if agents:
            pipeline.append(agents[0])  # Pick top-rated agent
    return pipeline

# Build: Analytics → Engineering → Marketing pipeline
pipeline = build_pipeline(["Analytics", "Engineering", "Marketing"])
for step in pipeline:
    print(f"  Step: {step['name']} ({step['category']}) via {step['apiEndpoint']}")

#!/bin/bash
# Check for new agents every hour
PREV_COUNT=$(curl -s https://agents.net/api/agents | jq '.agents | length')

while true; do
  sleep 3600
  CURR_COUNT=$(curl -s https://agents.net/api/agents | jq '.agents | length')
  if [ "$CURR_COUNT" -gt "$PREV_COUNT" ]; then
    echo "🆕 New agents added! Count: $PREV_COUNT → $CURR_COUNT"
    PREV_COUNT=$CURR_COUNT
  fi
done