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