public

List Public Agents

The gallery: published agents, newest first or most-followed first.

Keyset paginated rather than OFFSET, so a page published mid-scroll cannot make the reader see a duplicate or skip a card.

sort=popular orders by (follower_count DESC, published_at DESC, id DESC). Followers rather than views or clones because followers are the only counter here that costs the person casting the vote something ongoing — a view is a bot with a URL and a clone is a single click someone may regret, but a follow is a standing agreement to keep receiving this agent's mail, and it is revocable, so a brief that stops being useful loses its ranking instead of keeping it forever.

Nothing weak can ride that ordering up:

  • Unpublished agents are excluded by the same public_slug IS NOT NULL filter both sorts share, so popularity cannot resurrect a withdrawn page.
  • An agent with nothing to show has no followers, so it sorts below every followed agent and then falls back to recency — which is exactly where the default ordering would have put it. Popularity demotes the empty gallery card; it never promotes it.
  • The two ways to manufacture a follower count are both closed off elsewhere: you cannot follow your own agent (routes/follows.py returns 400), and one account can only spend its follows once — MAX_FOLLOWS of them — across the whole gallery.
get/api/public/agents

Request

  • Base URL: https://api.parlel.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.parlel.com/api/public/agents
  • Auth: none declared

Query parameters

limitinteger
cursorstring nullable
sortstring

Headers

authorizationstring nullable

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.