SIsignificant-gravitas
v2
store
public

List store agents

Changed on

Get a paginated list of agents from the marketplace, with optional filtering and sorting.

Used for:

  • Home Page Featured Agents
  • Home Page Top Agents
  • Search Results
  • Agent Details - Other Agents By Creator
  • Agent Details - Similar Agents
  • Creator Details - Agents By Creator
get/api/store/agents

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Query parameters

featuredboolean

Filter to only show featured agents

creatorstring nullable

Filter agents by creator username

categorystring nullable

Filter agents by category

search_querystring nullable

Literal + semantic search on names and descriptions

sorted_by'rating' | 'runs' | 'name' | 'updated_at'

Property to sort results by. Ignored if search_query is provided.

pageinteger
page_sizeinteger

Response

Successful Response

Example response

{
  "pagination": {
    "total_items": 42,
    "total_pages": 2,
    "current_page": 1,
    "page_size": 25
  }
}

Changes