Public Retriever API

List Public Retrievers

Changed on

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/v1/public/retrievers/

Request

  • Base URL
    https://api.mixpeek.com
  • Auth
    none required

Query parameters

pageinteger

Page number (1-indexed)

page_sizeinteger

Results per page

include_inactiveboolean

Include inactive retrievers in results

searchstring nullable

Search query for filtering by title or description

Response

Successful Response

total_countinteger required

Total number of public retrievers matching the query

pageinteger required

Current page number

page_sizeinteger required

Results per page

total_pagesinteger required

Total number of pages

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

    • 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