Marketplace API

Browse and search public Dyvas. Every endpoint on this page is read-only; rating a Dyva and adding one to your collection happen through the Dyvas API, not here.

2 min read7 endpoints

Every route and HTTP method below was checked directly against the live ts-api source on August 13, 2026. Response bodies are illustrative examples, never captured responses.

Base URL

https://api.dyva.ai/v1

GET `/v1/marketplace`

Browse public Dyvas. Filter, search, and sort. Responds with a plain array, not a paginated envelope: there is no total count in this response.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (8)

categorystringOptional: Category slug (see GET /v1/marketplace/categories for the live list).
sortstringOptional: One of "popular" (default), "new", "trending", "top_rated", or "relevance" (only meaningful together with q).
qstringOptional: Matches Dyva name, tagline, and category name.
tagstringOptional: Matches against tagline and personality fields, not a fixed tag taxonomy.
genderstringOptional: "female" or "male". Dyvas without a configured gender are excluded when this is set.
nsfwstringOptional: Set to "1" to show only mature/explicit/suggestive-rated Dyvas. Omit for safe-for-work results only.
limitintegerOptional: Maximum results (1-100). Defaults to 50.
offsetintegerOptional: Results to skip. There is no total count returned, so paging past the end simply returns an empty array.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0001",
    "slug": "brainstorm-buddy",
    "name": "Brainstorm Buddy",
    "tagline": "Your creative thinking partner",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
    "category_name": "Companion",
    "is_premium": false,
    "is_featured": false,
    "owner_name": "Dyva Team",
    "owner_username": "dyva_team",
    "owner_verified": true,
    "total_conversations": 8491,
    "avg_rating": 4.7,
    "rating_count": 342,
    "like_count": 1204,
    "voice_enabled": true,
    "content_rating": "sfw",
    "created_at": "2026-01-15T08:30:00Z"
  }
]

Examples (2)

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

GET `/v1/marketplace/featured`

Staff-curated Dyvas, ranked by likes and conversation count. Plain array, always up to 12 entries.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0001",
    "slug": "brainstorm-buddy",
    "name": "Brainstorm Buddy",
    "tagline": "Your creative thinking partner",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
    "category_name": "Companion",
    "is_featured": true,
    "total_conversations": 8491,
    "avg_rating": 4.7,
    "like_count": 1204
  }
]

Examples (1)

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

GET `/v1/marketplace/categories`

List marketplace categories with a live Dyva count in each. Use the slug for the category query parameter above.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Response

Illustrative example, not a captured response

[
  { "id": "cat_EXAMPLE01", "slug": "companion", "name": "Companion", "description": "Conversational companions", "icon": "heart", "count": 412 },
  { "id": "cat_EXAMPLE02", "slug": "roleplay",  "name": "Roleplay",  "description": "Characters and interactive fiction", "icon": "mask-happy", "count": 356 },
  { "id": "cat_EXAMPLE03", "slug": "creative",  "name": "Creative",  "description": "Writing and brainstorming", "icon": "pen-nib", "count": 189 }
]

Examples (1)

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

GET `/v1/marketplace/categories/:slug`

Public Dyvas within one category, ranked by the same weighted score as the browse endpoint's default sort.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

slugstringRequired: A category slug from GET /v1/marketplace/categories.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0001",
    "slug": "brainstorm-buddy",
    "name": "Brainstorm Buddy",
    "tagline": "Your creative thinking partner",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
    "total_conversations": 8491,
    "avg_rating": 4.7,
    "like_count": 1204,
    "voice_enabled": true,
    "content_rating": "sfw",
    "is_nsfw": false,
    "owner_username": "dyva_team",
    "category_name": "Companion"
  }
]

Examples (1)

curl "https://api.dyva.ai/v1/marketplace/categories/companion"

GET `/v1/marketplace/:id`

Full listing detail. Accepts a Dyva ID or its slug. Owner-only fields (system_prompt, tool_config, and a few others) are null unless you're authenticated as the owner.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The Dyva's ID or its slug.

Response

Illustrative example, not a captured response

{
  "id": "dyva_EXAMPLE0001",
  "owner_id": "usr_EXAMPLE0001",
  "slug": "brainstorm-buddy",
  "name": "Brainstorm Buddy",
  "tagline": "Your creative thinking partner",
  "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
  "banner_url": null,
  "voice_enabled": true,
  "visibility": "public",
  "is_featured": false,
  "marketplace_listed": true,
  "avg_rating": 4.7,
  "rating_count": 342,
  "total_conversations": 8491,
  "total_messages": 61204,
  "like_count": 1204,
  "content_rating": "sfw",
  "is_nsfw": false,
  "greeting_message": "Hey! What are we brainstorming today?",
  "conversation_starters": ["Give me 10 unconventional marketing ideas.", "Help me think through a product pivot."],
  "access_mode": "free",
  "min_tier": null,
  "owner_name": "Dyva Team",
  "owner_username": "dyva_team",
  "owner_verified": true,
  "system_prompt": null,
  "created_at": "2026-01-15T08:30:00Z",
  "updated_at": "2026-03-01T12:00:00Z"
}

Examples (2)

curl "https://api.dyva.ai/v1/marketplace/brainstorm-buddy"

GET `/v1/marketplace/:id/reviews`

Written ratings for a listing, newest first. Plain array; there is no rating-distribution or total field in this response.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (3)

idstringRequired: The Dyva's ID or its slug.
limitintegerOptional: Maximum reviews to return (max 50). Defaults to 20.
offsetintegerOptional: Reviews to skip for pagination.

Response

Illustrative example, not a captured response

[
  {
    "id": "rat_EXAMPLE0001",
    "rating": 5,
    "review": "Incredibly helpful for brainstorming. Feels like talking to a creative partner.",
    "user_name": "Alex",
    "created_at": "2026-03-09T14:22:00Z"
  },
  {
    "id": "rat_EXAMPLE0002",
    "rating": 4,
    "review": "Great for ideation sessions. Would love more structured frameworks.",
    "user_name": "Sam",
    "created_at": "2026-03-07T09:45:00Z"
  }
]

Examples (1)

curl "https://api.dyva.ai/v1/marketplace/brainstorm-buddy/reviews?limit=5"

GET `/v1/marketplace/:id/similar`

Up to 6 other public Dyvas in the same category, ranked by conversation count.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The Dyva's ID or its slug.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0002",
    "slug": "code-mentor",
    "name": "Code Mentor",
    "tagline": "Patient programming teacher",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0002.webp",
    "total_conversations": 14302,
    "avg_rating": 4.9
  }
]

Examples (1)

curl "https://api.dyva.ai/v1/marketplace/brainstorm-buddy/similar"

Browse the complete endpoint directory

Marketplace API

Browse and search public Dyvas. Every endpoint on this page is read-only; rating a Dyva and adding one to your collection happen through the Dyvas API, not here.

2 min read7 endpoints

Every route and HTTP method below was checked directly against the live ts-api source on August 13, 2026. Response bodies are illustrative examples, never captured responses.

Base URL

https://api.dyva.ai/v1

GET `/v1/marketplace`

Browse public Dyvas. Filter, search, and sort. Responds with a plain array, not a paginated envelope: there is no total count in this response.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (8)

categorystringOptional: Category slug (see GET /v1/marketplace/categories for the live list).
sortstringOptional: One of "popular" (default), "new", "trending", "top_rated", or "relevance" (only meaningful together with q).
qstringOptional: Matches Dyva name, tagline, and category name.
tagstringOptional: Matches against tagline and personality fields, not a fixed tag taxonomy.
genderstringOptional: "female" or "male". Dyvas without a configured gender are excluded when this is set.
nsfwstringOptional: Set to "1" to show only mature/explicit/suggestive-rated Dyvas. Omit for safe-for-work results only.
limitintegerOptional: Maximum results (1-100). Defaults to 50.
offsetintegerOptional: Results to skip. There is no total count returned, so paging past the end simply returns an empty array.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0001",
    "slug": "brainstorm-buddy",
    "name": "Brainstorm Buddy",
    "tagline": "Your creative thinking partner",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
    "category_name": "Companion",
    "is_premium": false,
    "is_featured": false,
    "owner_name": "Dyva Team",
    "owner_username": "dyva_team",
    "owner_verified": true,
    "total_conversations": 8491,
    "avg_rating": 4.7,
    "rating_count": 342,
    "like_count": 1204,
    "voice_enabled": true,
    "content_rating": "sfw",
    "created_at": "2026-01-15T08:30:00Z"
  }
]

Examples (2)

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

GET `/v1/marketplace/featured`

Staff-curated Dyvas, ranked by likes and conversation count. Plain array, always up to 12 entries.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0001",
    "slug": "brainstorm-buddy",
    "name": "Brainstorm Buddy",
    "tagline": "Your creative thinking partner",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
    "category_name": "Companion",
    "is_featured": true,
    "total_conversations": 8491,
    "avg_rating": 4.7,
    "like_count": 1204
  }
]

Examples (1)

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

GET `/v1/marketplace/categories`

List marketplace categories with a live Dyva count in each. Use the slug for the category query parameter above.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Response

Illustrative example, not a captured response

[
  { "id": "cat_EXAMPLE01", "slug": "companion", "name": "Companion", "description": "Conversational companions", "icon": "heart", "count": 412 },
  { "id": "cat_EXAMPLE02", "slug": "roleplay",  "name": "Roleplay",  "description": "Characters and interactive fiction", "icon": "mask-happy", "count": 356 },
  { "id": "cat_EXAMPLE03", "slug": "creative",  "name": "Creative",  "description": "Writing and brainstorming", "icon": "pen-nib", "count": 189 }
]

Examples (1)

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

GET `/v1/marketplace/categories/:slug`

Public Dyvas within one category, ranked by the same weighted score as the browse endpoint's default sort.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

slugstringRequired: A category slug from GET /v1/marketplace/categories.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0001",
    "slug": "brainstorm-buddy",
    "name": "Brainstorm Buddy",
    "tagline": "Your creative thinking partner",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
    "total_conversations": 8491,
    "avg_rating": 4.7,
    "like_count": 1204,
    "voice_enabled": true,
    "content_rating": "sfw",
    "is_nsfw": false,
    "owner_username": "dyva_team",
    "category_name": "Companion"
  }
]

Examples (1)

curl "https://api.dyva.ai/v1/marketplace/categories/companion"

GET `/v1/marketplace/:id`

Full listing detail. Accepts a Dyva ID or its slug. Owner-only fields (system_prompt, tool_config, and a few others) are null unless you're authenticated as the owner.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The Dyva's ID or its slug.

Response

Illustrative example, not a captured response

{
  "id": "dyva_EXAMPLE0001",
  "owner_id": "usr_EXAMPLE0001",
  "slug": "brainstorm-buddy",
  "name": "Brainstorm Buddy",
  "tagline": "Your creative thinking partner",
  "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0001.webp",
  "banner_url": null,
  "voice_enabled": true,
  "visibility": "public",
  "is_featured": false,
  "marketplace_listed": true,
  "avg_rating": 4.7,
  "rating_count": 342,
  "total_conversations": 8491,
  "total_messages": 61204,
  "like_count": 1204,
  "content_rating": "sfw",
  "is_nsfw": false,
  "greeting_message": "Hey! What are we brainstorming today?",
  "conversation_starters": ["Give me 10 unconventional marketing ideas.", "Help me think through a product pivot."],
  "access_mode": "free",
  "min_tier": null,
  "owner_name": "Dyva Team",
  "owner_username": "dyva_team",
  "owner_verified": true,
  "system_prompt": null,
  "created_at": "2026-01-15T08:30:00Z",
  "updated_at": "2026-03-01T12:00:00Z"
}

Examples (2)

curl "https://api.dyva.ai/v1/marketplace/brainstorm-buddy"

GET `/v1/marketplace/:id/reviews`

Written ratings for a listing, newest first. Plain array; there is no rating-distribution or total field in this response.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (3)

idstringRequired: The Dyva's ID or its slug.
limitintegerOptional: Maximum reviews to return (max 50). Defaults to 20.
offsetintegerOptional: Reviews to skip for pagination.

Response

Illustrative example, not a captured response

[
  {
    "id": "rat_EXAMPLE0001",
    "rating": 5,
    "review": "Incredibly helpful for brainstorming. Feels like talking to a creative partner.",
    "user_name": "Alex",
    "created_at": "2026-03-09T14:22:00Z"
  },
  {
    "id": "rat_EXAMPLE0002",
    "rating": 4,
    "review": "Great for ideation sessions. Would love more structured frameworks.",
    "user_name": "Sam",
    "created_at": "2026-03-07T09:45:00Z"
  }
]

Examples (1)

curl "https://api.dyva.ai/v1/marketplace/brainstorm-buddy/reviews?limit=5"

GET `/v1/marketplace/:id/similar`

Up to 6 other public Dyvas in the same category, ranked by conversation count.

Public

Route and method verified directly against the live ts-api source on August 13, 2026.

Path and query parameters (1)

idstringRequired: The Dyva's ID or its slug.

Response

Illustrative example, not a captured response

[
  {
    "id": "dyva_EXAMPLE0002",
    "slug": "code-mentor",
    "name": "Code Mentor",
    "tagline": "Patient programming teacher",
    "avatar_url": "https://cdn.dyva.ai/avatars/dyva_EXAMPLE0002.webp",
    "total_conversations": 14302,
    "avg_rating": 4.9
  }
]

Examples (1)

curl "https://api.dyva.ai/v1/marketplace/brainstorm-buddy/similar"

Browse the complete endpoint directory

GET /v1/marketplace

GET /v1/marketplace/featured

GET /v1/marketplace/categories

GET /v1/marketplace/categories/:slug

GET /v1/marketplace/:id

GET /v1/marketplace/:id/reviews

GET /v1/marketplace/:id/similar

GET /v1/marketplace

GET /v1/marketplace/featured

GET /v1/marketplace/categories

GET /v1/marketplace/categories/:slug

GET /v1/marketplace/:id

GET /v1/marketplace/:id/reviews

GET /v1/marketplace/:id/similar

GET `/v1/marketplace`

GET `/v1/marketplace/featured`

GET `/v1/marketplace/categories`

GET `/v1/marketplace/categories/:slug`

GET `/v1/marketplace/:id`

GET `/v1/marketplace/:id/reviews`

GET `/v1/marketplace/:id/similar`

GET `/v1/marketplace`

GET `/v1/marketplace/featured`

GET `/v1/marketplace/categories`

GET `/v1/marketplace/categories/:slug`

GET `/v1/marketplace/:id`

GET `/v1/marketplace/:id/reviews`

GET `/v1/marketplace/:id/similar`