Skip to main content
GET
/
v1
/
marketplace
/
catalog
Browse Marketplace Catalog
curl --request GET \
  --url https://api.mixpeek.com/v1/marketplace/catalog \
  --header 'Authorization: Bearer <token>'
[
  {
    "internal_id": "<string>",
    "namespace_id": "<string>",
    "retriever_id": "<string>",
    "title": "<string>",
    "description": "<string>",
    "public_name": "<string>",
    "available_tiers": [
      {
        "tier": "free",
        "price_per_month": 0,
        "limits": {
          "requests_per_minute": 123,
          "requests_per_hour": 123,
          "requests_per_day": 123,
          "requests_per_month": 123
        },
        "features": [
          "<string>"
        ],
        "stripe_price_id": "<string>"
      }
    ],
    "listing_id": "<string>",
    "category": "<string>",
    "tags": [
      "<string>"
    ],
    "logo_url": "<string>",
    "app_url": "https://nga.mxp.co",
    "icon_base64": "data:image/png;base64,iVBORw0KGgoAAAANS...",
    "display_config": {
      "components": [
        {
          "props": {
            "field": "video_url",
            "label": "Enter video URL"
          },
          "type": "SearchInput"
        },
        {
          "props": {
            "fields": [
              "title",
              "description",
              "score"
            ],
            "layout": "grid"
          },
          "type": "ResultCard"
        }
      ],
      "theme": {
        "fontFamily": "Inter, sans-serif",
        "primaryColor": "#007AFF"
      }
    },
    "password_secret_name": "marketplace_password",
    "status": "draft",
    "visibility": "unlisted",
    "is_active": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "published_at": "2023-11-07T05:31:56Z",
    "total_subscribers": 0,
    "total_queries": 0
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
category
string | null

Filter by category (e.g., 'Content Moderation', 'Search')

​
tags
string[] | null

Filter by tags (AND logic - listing must have all tags)

​
search
string | null

Search in title and description

​
skip
integer
default:0

Number of listings to skip

Required range: x >= 0
​
limit
integer
default:20

Number of listings to return

Required range: 1 <= x <= 100

Response

Successful Response

​
internal_id
string
required

Organization that owns this listing (provider)

​
namespace_id
string
required

Namespace containing the retriever

​
retriever_id
string
required

Retriever being offered in the marketplace

​
title
string
required

Public display title

Examples:

"Brand Safety Classification API"

"Video Search Engine"

​
description
string
required

Public description of what this listing provides

​
public_name
string
required

Public URL-safe slug for the listing (e.g., 'video-search'). Used in public URL: mxp.co/m/{public_name}. Must be globally unique.

Required string length: 3 - 50
Examples:

"brand-safety-api"

"video-search"

"product-catalog"

​
available_tiers
SubscriptionTierConfig · object[]
required

Available subscription tiers (must include at least one tier, typically FREE for public listings)

​
listing_id
string

Unique identifier for the listing

​
category
string | null

Category for browsing (e.g., 'Content Moderation', 'Search')

​
tags
string[]

Tags for discovery

​
logo_url
string | null

URL to listing logo/icon

​
app_url
string | null

Optional URL to a live canvas app powered by this retriever (e.g., 'https://nga.mxp.co'). When set, the listing appears in the public showcase at mixpeek.com/showcase.

Example:

"https://nga.mxp.co"

​
icon_base64
string | null

Base64 encoded icon/favicon (data URI format). Max size: ~200KB encoded. Use for small icons.

Maximum string length: 300000
Example:

"data:image/png;base64,iVBORw0KGgoAAAANS..."

​
display_config
Display Config · object

JSON-based UI configuration for the public interface. Follows a component-based schema (inspired by json-render): { 'components': [...], 'theme': {...}, 'layout': {...} }. If not provided, a default UI is generated from retriever input_schema.

Example:
{
  "components": [
    {
      "props": {
        "field": "video_url",
        "label": "Enter video URL"
      },
      "type": "SearchInput"
    },
    {
      "props": {
        "fields": ["title", "description", "score"],
        "layout": "grid"
      },
      "type": "ResultCard"
    }
  ],
  "theme": {
    "fontFamily": "Inter, sans-serif",
    "primaryColor": "#007AFF"
  }
}
​
password_secret_name
string | null

Optional organization secret name containing password for access protection. If set, users must provide password to subscribe (even for free tier).

Example:

"marketplace_password"

​
status
enum<string>
default:draft

Publication status

Available options:
draft,
published,
archived,
suspended
​
visibility
enum<string>
default:unlisted

Visibility level. 'listed' = shown in marketplace catalog & homepage showcase. 'unlisted' = accessible via direct link only (not in catalog).

Available options:
listed,
unlisted
​
is_active
boolean
default:true
deprecated

DEPRECATED: Use 'status' field instead. Computed from status (True if PUBLISHED, False otherwise).

​
created_at
string<date-time>

When the listing was created

​
updated_at
string<date-time>

When the listing was last updated

​
published_at
string<date-time> | null

When the listing was first published

​
total_subscribers
integer
default:0

Total number of active subscribers

​
total_queries
integer
default:0

Total queries executed across all subscribers