List Public Retrievers

curl --request GET \
  --url https://api.mixpeek.com/v1/public/retrievers/ \
  --header 'Authorization: Bearer <token>'

{
  "results": [
    {
      "public_name": "<string>",
      "public_url": "<string>",
      "title": "<string>",
      "password_protected": true,
      "is_active": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "logo_url": "<string>",
      "og_image_url": "<string>"
    }
  ],
  "total_count": 123,
  "page": 123,
  "page_size": 123,
  "total_pages": 123,
  "stats": {
    "total_active": 0,
    "total_password_protected": 0,
    "total_open": 0
  }
}

Public API

List Public Retrievers

List all public retrievers with pagination and search.

This endpoint allows browsing and discovering all published retrievers across all organizations. No authentication required.

Authentication:

NO authentication required - completely public endpoint
Discover retrievers created by all Mixpeek users

Pagination:

Default: page=1, page_size=20
Maximum page_size: 100
Returns total count and total pages

Search:

Search across retriever titles and descriptions
Case-insensitive regex matching
Combine with pagination

Filtering:

By default, only active retrievers are shown
Set include_inactive=true to see all retrievers

Response includes:

List of public retrievers with basic info
Pagination details (page, page_size, total_count, total_pages)
Aggregate statistics (total active, password protected, open)

What’s NOT exposed:

API keys (except in individual config endpoint)
Internal IDs or organization details
Full retriever configuration (use template endpoint for that)
Password values (only password_protected: true/false)

Example:

# List all public retrievers (first page)
curl -X GET "https://api.mixpeek.com/v1/public/retrievers/"

# Search for video-related retrievers
curl -X GET "https://api.mixpeek.com/v1/public/retrievers/?search=video&page_size=50"

# Get page 2 with custom page size
curl -X GET "https://api.mixpeek.com/v1/public/retrievers/?page=2&page_size=50"

Use Cases:

Browse available public retrievers
Discover search patterns and implementations
Find retrievers to use as templates
Explore what others have built

GET

public

retrievers

List Public Retrievers

curl --request GET \
  --url https://api.mixpeek.com/v1/public/retrievers/ \
  --header 'Authorization: Bearer <token>'

{
  "results": [
    {
      "public_name": "<string>",
      "public_url": "<string>",
      "title": "<string>",
      "password_protected": true,
      "is_active": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "logo_url": "<string>",
      "og_image_url": "<string>"
    }
  ],
  "total_count": 123,
  "page": 123,
  "page_size": 123,
  "total_pages": 123,
  "stats": {
    "total_active": 0,
    "total_password_protected": 0,
    "total_open": 0
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page

integer

default:1

Page number (1-indexed)

Required range: x >= 1

page_size

integer

default:20

Results per page (max 100)

Required range: 1 <= x <= 100

include_inactive

boolean

default:false

Include inactive retrievers in results

string | null

Search query for filtering by title or description

Response

Successful Response

Response for listing public retrievers.

Follows the same pattern as ListCollectionsResponse for consistent developer experience.

results

PublicRetrieverListItem · object[]

required

List of public retrievers

Show child attributes

results.public_name

string

required

Public URL-safe name used in the public URL

results.public_url

string

required

Full public URL to the retriever page

results.title

string

required

Display title from display_config

results.password_protected

boolean

required

Whether password authentication is required

results.is_active

boolean

required

Whether the retriever is active

results.created_at

string<date-time>

required

When the retriever was published

results.updated_at

string<date-time>

required

When the retriever was last updated

results.description

string | null

Display description from display_config

results.logo_url

string | null

Logo URL from display_config

results.og_image_url

string | null

Social preview/OG image URL from display_config

total_count

integer

required

Total number of public retrievers matching the query

page

integer

required

Current page number

page_size

integer

required

Results per page

total_pages

integer

required

Total number of pages

stats

PublicRetrieverListStats · object

Aggregate statistics across all public retrievers

Show child attributes

stats.total_active

integer

default:0

Number of active public retrievers

stats.total_password_protected

integer

default:0

Number of password-protected retrievers

stats.total_open

integer

default:0

Number of fully open (no password) retrievers

Check Name Availability Execute Public Retriever

⌘I

Health

Organizations

Namespaces

Buckets

Feature Extractors

Collections

Retrievers

Taxonomies

Clusters

Templates

Analytics

Resource Search

Inference

Agent Sessions

Tasks

Webhooks

Notifications

Triggers

List Public Retrievers

Authorizations

Query Parameters

Response