List Public Retrievers
Changed onList 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
Request
- Base URLhttps://api.mixpeek.com
- Authnone required
Query parameters
Page number (1-indexed)
Results per page
Include inactive retrievers in results
Search query for filtering by title or description
Response
Successful Response
Example response
{
"results": [
{
"public_url": "https://mxp.co/r/video-search",
"title": "Video Search",
"external_links": [
{
"name": "GitHub Repository",
"url": "https://github.com/mixpeek/video-search"
}
]
}
]
}Changes
- warning
removed the optional property
from the response with the status - info
added the non-success response with the status
- info
added the non-success response with the status
- info
added the optional property
to the response with the status - info
added the required property
to the response with the status - info
added the required property
to the response with the status
- warning
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status - info
added the optional property
/to the response with the status
- info