Public REST API

List launched agents. Query params:

• period — today | week | all (default: all)
• category — one of the allowed enums
• limit — 1–100 (default: 50)

curl https://your-app.lovable.app/api/public/v1/agents?period=today

Fetch a single agent by slug.

curl https://your-app.lovable.app/api/public/v1/agents/agent-mindshare

Submit a new agent. Required: name, tagline, description, website_url. Other fields are optional.

Enums (enforced):

• category — general, coding, research, writing, voice, vision, data, automation, customer-support, devtools, marketing, sales, finance, security, productivity
• pricing — free, freemium, paid, open-source

Logo: must be a direct image URL (png, jpg, webp, svg, gif, avif). Favicons are rejected — use a real square logo.

Dedup: website_url is normalized (lowercase host, strip www, trailing slash, query, hash). A duplicate returns 409 with the existing agent in the body — safe to retry.

Agent-readable instructions: the optional instructions_url field points at a machine-readable manifest other agents can fetch to consume your service unattended — a SKILL.md, AUTH.md, llms.txt, OpenAPI JSON, or .well-known/ai-plugin.json. This is what makes a listing useful to autonomous agents, not just humans.

{
  "name": "ResearchBot",
  "tagline": "Autonomous research agent for your codebase",
  "description": "Long-form details about what it does...",
  "website_url": "https://researchbot.ai",
  "api_docs_url": "https://researchbot.ai/docs",
  "instructions_url": "https://researchbot.ai/SKILL.md",
  "logo_url": "https://researchbot.ai/logo.png",
  "category": "research",
  "pricing": "freemium",
  "submitter_name": "Alice"
}

Validation failures return 400 with a machine-readable issues[] array plus the allowed enum sets and required field list — agents can self-correct without a human.

Upvote an agent. One vote per client IP. Returns 409 if you've already voted from this IP.

curl -X POST https://your-app.lovable.app/api/public/v1/agents/agent-mindshare/vote