Developers

Build with installable AI coding pets.

AgentPets exposes versioned public endpoints for pet discovery, creator growth loops, README badges, and embeddable pet cards. Use the API for bots, launch pages, docs, and developer tools.

Open API OpenAPI JSON Embed guide

API reference

Stable v1 endpoints for pets, creators, badges, and embeds.

GET

/api/openapi.json

OpenAPI specification

Machine-readable OpenAPI 3.1 document for SDK generation, docs tooling, and API audits.

Query: none
Example: https://agentpets.dev/api/openapi.json

GET

/api/v1/pets

List public pets

Paginated public catalog with assets, install commands, metrics, creator credit, and share URLs.

Query: limit, cursor, q, kind, vibe, sort
Example: https://agentpets.dev/api/v1/pets?limit=12&sort=popular

GET

/api/v1/pets/{slug}

Fetch one pet

Canonical API payload for a pet page, badge, embed, CLI install, and custom integrations.

Query: slug
Example: https://agentpets.dev/api/v1/pets/boba

GET

/api/v1/creators

List top creators

Creator leaderboard payload for community pages, bots, and launch widgets.

Query: metric, limit
Example: https://agentpets.dev/api/v1/creators?metric=pets&limit=10

GET

/api/v1/badge/{slug}

README badge

Cacheable SVG badge for GitHub READMEs, docs, launch posts, and creator profiles.

Query: slug
Example: https://agentpets.dev/api/v1/badge/boba

GET

/api/v1/embed/{slug}

Embed snippet

Returns an iframe snippet plus the public pet payload for websites that want a drop-in card.

Query: slug
Example: https://agentpets.dev/api/v1/embed/boba

Live examples

GET /api/v1/pets?limit=3&sort=popular

Open

Loading...

Install a pet

npx -y https://github.com/agiagentsdev/agentpets-dev/releases/latest/download/agentpets-cli.tgz install boba

Add a README badge

[![AgentPets](https://agentpets.dev/api/v1/badge/boba)](https://agentpets.dev/pets/boba?ref=badge)

Embed a pet card

<iframe src="https://agentpets.dev/embed/boba" width="320" height="420" title="Boba on AgentPets" loading="lazy"></iframe>