Marketplace API

Browse, search, and discover public REPLRs shared by the community. Rate and review listings, or add them to your own collection with a single API call.

GET/v1/marketplace

Browse and search public REPLRs listed on the marketplace. Supports filtering by category, sorting, and full-text search.

Path Parameters

Name	Type	Required	Description
`category`	string	Optional	Filter by category slug (e.g. assistant, creative, education, entertainment, productivity, roleplay, companion).
`sort`	string	Optional	Sort order. One of "popular", "recent", "trending", or "top_rated". Defaults to "popular".
`limit`	integer	Optional	Maximum number of results to return (1-100). Defaults to 20.
`offset`	integer	Optional	Number of results to skip for pagination. Defaults to 0.
`q`	string	Optional	Full-text search query. Matches against REPLR name, description, and tags.

Response

{
  "data": [
    {
      "id": "mkt_9xkW3vQbN2",
      "replr_id": "rpl_T4mKqZw8X1",
      "name": "Brainstorm Buddy",
      "tagline": "Your creative thinking partner",
      "description": "An AI collaborator that helps you generate ideas, challenge assumptions, and think through problems from multiple angles.",
      "category": "assistant",
      "tags": ["brainstorming", "creativity", "problem-solving"],
      "author": {
        "id": "usr_Lp3nR8vY",
        "display_name": "replr_team",
        "verified": true
      },
      "rating": 4.7,
      "review_count": 342,
      "use_count": 8491,
      "avatar_url": "https://cdn.replr.ai/avatars/brainstorm-buddy.webp",
      "created_at": "2026-01-15T08:30:00Z",
      "updated_at": "2026-03-01T12:00:00Z"
    },
    {
      "id": "mkt_Fw2pJdN7Ql",
      "replr_id": "rpl_Hv6xBmC3Y9",
      "name": "Code Mentor",
      "tagline": "Patient programming teacher",
      "description": "Explains concepts step by step, reviews your code, and helps you learn any language from Python to Rust.",
      "category": "education",
      "tags": ["coding", "programming", "learning"],
      "author": {
        "id": "usr_Qk9mT2wP",
        "display_name": "devtools_inc",
        "verified": true
      },
      "rating": 4.9,
      "review_count": 571,
      "use_count": 14302,
      "avatar_url": "https://cdn.replr.ai/avatars/code-mentor.webp",
      "created_at": "2026-02-03T14:20:00Z",
      "updated_at": "2026-03-05T09:15:00Z"
    }
  ],
  "total": 247,
  "limit": 20,
  "offset": 0
}

Examples

curl "https://api.replr.ai/v1/marketplace?category=assistant&sort=popular&limit=10"

GET/v1/marketplace/featured

Retrieve featured and staff-picked REPLRs. These are hand-curated listings highlighted by the REPLR team.

Response

{
  "data": [
    {
      "id": "mkt_9xkW3vQbN2",
      "name": "Brainstorm Buddy",
      "tagline": "Your creative thinking partner",
      "category": "assistant",
      "author": {
        "id": "usr_Lp3nR8vY",
        "display_name": "replr_team",
        "verified": true
      },
      "rating": 4.7,
      "review_count": 342,
      "use_count": 8491,
      "avatar_url": "https://cdn.replr.ai/avatars/brainstorm-buddy.webp",
      "featured_reason": "Staff Pick - March 2026"
    },
    {
      "id": "mkt_Kx5tRnM4Wz",
      "name": "Story Weaver",
      "tagline": "Collaborative fiction engine",
      "category": "creative",
      "author": {
        "id": "usr_Bn7hY3kJ",
        "display_name": "narrativelab",
        "verified": false
      },
      "rating": 4.8,
      "review_count": 189,
      "use_count": 5620,
      "avatar_url": "https://cdn.replr.ai/avatars/story-weaver.webp",
      "featured_reason": "Trending this week"
    }
  ]
}

Examples

curl "https://api.replr.ai/v1/marketplace/featured"

GET/v1/marketplace/categories

List all available marketplace categories. Use these slugs when filtering listings via the category query parameter.

Response

{
  "data": [
    { "slug": "assistant",      "name": "Assistant",      "description": "General-purpose helpers and productivity tools",   "count": 84  },
    { "slug": "creative",       "name": "Creative",       "description": "Writing, art direction, and brainstorming",        "count": 63  },
    { "slug": "education",      "name": "Education",      "description": "Tutoring, language learning, and study aids",      "count": 47  },
    { "slug": "entertainment",  "name": "Entertainment",  "description": "Games, trivia, and fun interactions",              "count": 39  },
    { "slug": "productivity",   "name": "Productivity",   "description": "Task management, scheduling, and workflows",      "count": 31  },
    { "slug": "roleplay",       "name": "Roleplay",       "description": "Characters, scenarios, and interactive fiction",   "count": 56  },
    { "slug": "companion",      "name": "Companion",      "description": "Conversational companions and social interaction", "count": 72  }
  ]
}

Examples

curl "https://api.replr.ai/v1/marketplace/categories"

GET/v1/marketplace/:id

Get full details for a single marketplace listing, including its rating, review count, total uses, and the complete REPLR configuration.

Path Parameters

Name	Type	Required	Description
`id`	string	Required	The marketplace listing ID (e.g. mkt_9xkW3vQbN2).

Response

{
  "data": {
    "id": "mkt_9xkW3vQbN2",
    "replr_id": "rpl_T4mKqZw8X1",
    "name": "Brainstorm Buddy",
    "tagline": "Your creative thinking partner",
    "description": "An AI collaborator that helps you generate ideas, challenge assumptions, and think through problems from multiple angles. Great for product ideation, writing prompts, business strategy, and creative projects.",
    "category": "assistant",
    "tags": ["brainstorming", "creativity", "problem-solving", "ideation"],
    "author": {
      "id": "usr_Lp3nR8vY",
      "display_name": "replr_team",
      "verified": true,
      "avatar_url": "https://cdn.replr.ai/users/replr-team.webp"
    },
    "rating": 4.7,
    "review_count": 342,
    "use_count": 8491,
    "rating_distribution": {
      "5": 218,
      "4": 87,
      "3": 25,
      "2": 8,
      "1": 4
    },
    "avatar_url": "https://cdn.replr.ai/avatars/brainstorm-buddy.webp",
    "sample_messages": [
      "Give me 10 unconventional marketing ideas for a local bakery.",
      "Help me think through the pros and cons of this product pivot.",
      "Let's do a creative brainstorm around sustainable packaging."
    ],
    "created_at": "2026-01-15T08:30:00Z",
    "updated_at": "2026-03-01T12:00:00Z"
  }
}

Examples

curl "https://api.replr.ai/v1/marketplace/mkt_9xkW3vQbN2"

POST/v1/marketplace/:id/rateAuth Required

Submit a rating and optional review for a marketplace REPLR. Each user can only rate a listing once; subsequent calls update the existing rating.

Path Parameters

Name	Type	Required	Description
`id`	string	Required	The marketplace listing ID to rate.

Request Body

Name	Type	Required	Description
`rating`	integer	Required	Rating from 1 to 5.
`review`	string	Optional	Optional written review (max 2000 characters).

Response

{
  "data": {
    "id": "rev_Mn4kXp8Qw2",
    "listing_id": "mkt_9xkW3vQbN2",
    "user_id": "usr_Jy7tRc3Vn",
    "rating": 5,
    "review": "Incredibly helpful for brainstorming. Feels like talking to a creative partner.",
    "created_at": "2026-03-09T14:22:00Z",
    "updated_at": "2026-03-09T14:22:00Z"
  }
}

Examples

curl -X POST "https://api.replr.ai/v1/marketplace/mkt_9xkW3vQbN2/rate" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"rating": 5, "review": "Incredibly helpful for brainstorming. Feels like talking to a creative partner."}'

GET/v1/marketplace/:id/reviews

Retrieve paginated reviews for a marketplace listing. Includes the reviewer's display name, rating, and review text.

Path Parameters

Name	Type	Required	Description
`id`	string	Required	The marketplace listing ID.
`sort`	string	Optional	Sort order for reviews. One of "recent", "highest", or "lowest". Defaults to "recent".
`limit`	integer	Optional	Maximum number of reviews to return (1-50). Defaults to 20.
`offset`	integer	Optional	Number of reviews to skip for pagination. Defaults to 0.

Response

{
  "data": [
    {
      "id": "rev_Mn4kXp8Qw2",
      "user": {
        "id": "usr_Jy7tRc3Vn",
        "display_name": "alex_creates"
      },
      "rating": 5,
      "review": "Incredibly helpful for brainstorming. Feels like talking to a creative partner.",
      "created_at": "2026-03-09T14:22:00Z"
    },
    {
      "id": "rev_Bt6wHn2Yk8",
      "user": {
        "id": "usr_Wp5mLx9Fk",
        "display_name": "startup_sam"
      },
      "rating": 4,
      "review": "Great for ideation sessions. Would love more structured frameworks.",
      "created_at": "2026-03-07T09:45:00Z"
    },
    {
      "id": "rev_Qz3rJm7Nc5",
      "user": {
        "id": "usr_Dn8kYv4Gt",
        "display_name": "writer_jo"
      },
      "rating": 5,
      "review": "Used this to outline my entire novel. The back-and-forth brainstorming flow is perfect.",
      "created_at": "2026-03-04T18:10:00Z"
    }
  ],
  "total": 342,
  "limit": 5,
  "offset": 0
}

Examples

curl "https://api.replr.ai/v1/marketplace/mkt_9xkW3vQbN2/reviews?sort=recent&limit=5"

POST/v1/marketplace/:id/useAuth Required

Add a marketplace REPLR to your personal collection. This creates a private copy that you can customize and chat with independently.

Path Parameters

Name	Type	Required	Description
`id`	string	Required	The marketplace listing ID to add to your collection.

Response

{
  "data": {
    "replr_id": "rpl_Nz8mVw3Kx6",
    "source_listing_id": "mkt_9xkW3vQbN2",
    "name": "Brainstorm Buddy",
    "status": "active",
    "message": "REPLR added to your collection. You can now start a conversation or customize it.",
    "created_at": "2026-03-09T14:30:00Z"
  }
}

Examples

curl -X POST "https://api.replr.ai/v1/marketplace/mkt_9xkW3vQbN2/use" \
  -H "Authorization: Bearer sk_live_..."

Name

Type

Required

Description

category

string

Optional

Filter by category slug (e.g. assistant, creative, education, entertainment, productivity, roleplay, companion).

sort

string

Optional

Sort order. One of "popular", "recent", "trending", or "top_rated". Defaults to "popular".

limit

integer

Optional

Maximum number of results to return (1-100). Defaults to 20.

offset

integer

Optional

Number of results to skip for pagination. Defaults to 0.

q

string

Optional

Full-text search query. Matches against REPLR name, description, and tags.

{ "data": [ { "id": "mkt_9xkW3vQbN2", "replr_id": "rpl_T4mKqZw8X1", "name": "Brainstorm Buddy", "tagline": "Your creative thinking partner", "description": "An AI collaborator that helps you generate ideas, challenge assumptions, and think through problems from multiple angles.", "category": "assistant", "tags": ["brainstorming", "creativity", "problem-solving"], "author": { "id": "usr_Lp3nR8vY", "display_name": "replr_team", "verified": true }, "rating": 4.7, "review_count": 342, "use_count": 8491, "avatar_url": "https://cdn.replr.ai/avatars/brainstorm-buddy.webp", "created_at": "2026-01-15T08:30:00Z", "updated_at": "2026-03-01T12:00:00Z" }, { "id": "mkt_Fw2pJdN7Ql", "replr_id": "rpl_Hv6xBmC3Y9", "name": "Code Mentor", "tagline": "Patient programming teacher", "description": "Explains concepts step by step, reviews your code, and helps you learn any language from Python to Rust.", "category": "education", "tags": ["coding", "programming", "learning"], "author": { "id": "usr_Qk9mT2wP", "display_name": "devtools_inc", "verified": true }, "rating": 4.9, "review_count": 571, "use_count": 14302, "avatar_url": "https://cdn.replr.ai/avatars/code-mentor.webp", "created_at": "2026-02-03T14:20:00Z", "updated_at": "2026-03-05T09:15:00Z" } ], "total": 247, "limit": 20, "offset": 0 }

{ "data": [ { "id": "mkt_9xkW3vQbN2", "name": "Brainstorm Buddy", "tagline": "Your creative thinking partner", "category": "assistant", "author": { "id": "usr_Lp3nR8vY", "display_name": "replr_team", "verified": true }, "rating": 4.7, "review_count": 342, "use_count": 8491, "avatar_url": "https://cdn.replr.ai/avatars/brainstorm-buddy.webp", "featured_reason": "Staff Pick - March 2026" }, { "id": "mkt_Kx5tRnM4Wz", "name": "Story Weaver", "tagline": "Collaborative fiction engine", "category": "creative", "author": { "id": "usr_Bn7hY3kJ", "display_name": "narrativelab", "verified": false }, "rating": 4.8, "review_count": 189, "use_count": 5620, "avatar_url": "https://cdn.replr.ai/avatars/story-weaver.webp", "featured_reason": "Trending this week" } ] }

{ "data": [ { "slug": "assistant", "name": "Assistant", "description": "General-purpose helpers and productivity tools", "count": 84 }, { "slug": "creative", "name": "Creative", "description": "Writing, art direction, and brainstorming", "count": 63 }, { "slug": "education", "name": "Education", "description": "Tutoring, language learning, and study aids", "count": 47 }, { "slug": "entertainment", "name": "Entertainment", "description": "Games, trivia, and fun interactions", "count": 39 }, { "slug": "productivity", "name": "Productivity", "description": "Task management, scheduling, and workflows", "count": 31 }, { "slug": "roleplay", "name": "Roleplay", "description": "Characters, scenarios, and interactive fiction", "count": 56 }, { "slug": "companion", "name": "Companion", "description": "Conversational companions and social interaction", "count": 72 } ] }

Name

Type

Required

Description

id

string

Required

The marketplace listing ID (e.g. mkt_9xkW3vQbN2).

{ "data": { "id": "mkt_9xkW3vQbN2", "replr_id": "rpl_T4mKqZw8X1", "name": "Brainstorm Buddy", "tagline": "Your creative thinking partner", "description": "An AI collaborator that helps you generate ideas, challenge assumptions, and think through problems from multiple angles. Great for product ideation, writing prompts, business strategy, and creative projects.", "category": "assistant", "tags": ["brainstorming", "creativity", "problem-solving", "ideation"], "author": { "id": "usr_Lp3nR8vY", "display_name": "replr_team", "verified": true, "avatar_url": "https://cdn.replr.ai/users/replr-team.webp" }, "rating": 4.7, "review_count": 342, "use_count": 8491, "rating_distribution": { "5": 218, "4": 87, "3": 25, "2": 8, "1": 4 }, "avatar_url": "https://cdn.replr.ai/avatars/brainstorm-buddy.webp", "sample_messages": [ "Give me 10 unconventional marketing ideas for a local bakery.", "Help me think through the pros and cons of this product pivot.", "Let's do a creative brainstorm around sustainable packaging." ], "created_at": "2026-01-15T08:30:00Z", "updated_at": "2026-03-01T12:00:00Z" } }

Name

Type

Required

Description

id

string

Required

The marketplace listing ID to rate.

Name

Type

Required

Description

rating

integer

Required

Rating from 1 to 5.

review

string

Optional

Optional written review (max 2000 characters).

{ "data": { "id": "rev_Mn4kXp8Qw2", "listing_id": "mkt_9xkW3vQbN2", "user_id": "usr_Jy7tRc3Vn", "rating": 5, "review": "Incredibly helpful for brainstorming. Feels like talking to a creative partner.", "created_at": "2026-03-09T14:22:00Z", "updated_at": "2026-03-09T14:22:00Z" } }

curl -X POST "https://api.replr.ai/v1/marketplace/mkt_9xkW3vQbN2/rate" \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{"rating": 5, "review": "Incredibly helpful for brainstorming. Feels like talking to a creative partner."}'

Name

Type

Required

Description

id

string

Required

The marketplace listing ID.

sort

string

Optional

Sort order for reviews. One of "recent", "highest", or "lowest". Defaults to "recent".

limit

integer

Optional

Maximum number of reviews to return (1-50). Defaults to 20.

offset

integer

Optional

Number of reviews to skip for pagination. Defaults to 0.

{ "data": [ { "id": "rev_Mn4kXp8Qw2", "user": { "id": "usr_Jy7tRc3Vn", "display_name": "alex_creates" }, "rating": 5, "review": "Incredibly helpful for brainstorming. Feels like talking to a creative partner.", "created_at": "2026-03-09T14:22:00Z" }, { "id": "rev_Bt6wHn2Yk8", "user": { "id": "usr_Wp5mLx9Fk", "display_name": "startup_sam" }, "rating": 4, "review": "Great for ideation sessions. Would love more structured frameworks.", "created_at": "2026-03-07T09:45:00Z" }, { "id": "rev_Qz3rJm7Nc5", "user": { "id": "usr_Dn8kYv4Gt", "display_name": "writer_jo" }, "rating": 5, "review": "Used this to outline my entire novel. The back-and-forth brainstorming flow is perfect.", "created_at": "2026-03-04T18:10:00Z" } ], "total": 342, "limit": 5, "offset": 0 }

Name

Type

Required

Description

id

string

Required

The marketplace listing ID to add to your collection.

{ "data": { "replr_id": "rpl_Nz8mVw3Kx6", "source_listing_id": "mkt_9xkW3vQbN2", "name": "Brainstorm Buddy", "status": "active", "message": "REPLR added to your collection. You can now start a conversation or customize it.", "created_at": "2026-03-09T14:30:00Z" } }